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ri T S K A T E is a po w © r f u 1. g e n e r a 1 p u r p o s e p r o g r a in d e v e X o p m e n t 
system for the 80 80 which can he used as a text editor? a monitor* 
an assembler* and even an operating system * The text editor and 
m o n i t o r a 1 1 o w p o w e r f u 1 o o n t e n t o r i e n t e d o o m m a n d s * T h e e n t i r e s y s •••• 
•tern is programmable through variables v repetitive loops and com- 
fit a n d m a e r o s ♦ T h e a s s e m b 1 e r p r o v :i. d e s g r e a t f I. e x :i b i .1 :i. t y h y a 1 1 o w i n g 
its two passes to be invoked separately* The user has full control 
over all memory allocation? including placement of the symbol 
table* Source programs? object programs and symbol tables cari all 
b e s t o r e d o n a n d r e t r :i. e v e d f r o m t h e d :i. s k * T h e d i s k. c o m m a n d s a u t o •••• 
iti a t i c a 1 1 y a 1 1 o c a t e a ri d d e a 1 1 o e a t e d i s k s p a c e y h a n d 1 i n g c o in p a e t i n g 

f t h e d 1 s k w h e n v e r n e e e s s a r y ♦ A 1 t h o u g h e o n f :i. g u r e d f o r t h e :i. s k 
. .1 o o k e y d i s k c o n t r o 1 1 e r b o a r d ? a 1 1 1 / c a 1 1 s a r e h a n d !l e d t h r o u g h 
s p e c i. a 1 v e c t o r s ? s o t h a t i f y o u h a v e s o m e o t h e r t y p e o f h a r d w a r e 
t h :i. s m a n u a 1 w i 1 1 e x p 1 a 1 n h o w 1 S K A T E c a n b e o ». i s t o m i z e d * 

The manual is divided into three major parts* Part I? called 
Usage? explains how to use the various features of Til SKATE* You 
w i 1 1 w a n t t o r e a d t h i s c a r e f u 1 1 y b e f o r e b e g :i. n n i n g t o u s e 1 S K A T E ? 
b i. j t o n c e y o u a r e f a m :i. 1 :i. a r w i t h t h e p r o g r a m y o u w i 1 1 p r o b a b 1 y o o n - 
suit this section only inf reouentlw* The right hand margin of 
this part has left space for important keywords so that you can 
cauicklu locate where concepts av& explained* You maw also want to 
use this space for notes of your own* Part 1 is divided into sec- 
tions based on how OX SKATE is to be used* This is done for great™ 
e r o o h e r e n e e i n e x p 1 a :i. n i n g h o w t h e o o m m a n d s w o r k ? b u t t h e r e w i 1 1 
inevitably be some overlap* Some of the commands work differently 
in monitor usage than in text editing usage? for example? and so 
a r e d i s c u s s e d i n b o t h s e c t i o n s ♦ A 1 1 X S K A T E e o m m a i "i d s a v e i n i^ r o - 
d u c e d i n P art X ? w i t h t h e s :i. n s 1 e e x c e p t i o n o f t h e U c o m m a n d w h i c h 
can only be used in machine lari«H.ia#e programs? and so is discussed 
in Part XX ♦ 

P a r t X X 1 s c a 1 1 e d X n s t a X 1 a t i o n a n d M a i n t e n a n o e * X t e x p 1 a i n s 
the nitty gritty of how to get this software running on your hard- 
ware? and how to make the proper changes- in 01 SKATE to customize 
y o u r s y s t e m ♦ X t a X s o <•* i v e s t h e d e t a i X s o f h o w t o i n t e r f a c e X S K - 
A T In! t o m a c h i n e X a n g u a g e p r o g r a m s ♦ 

Part XXX is the System Reference Summary* AX most alX the ma- 
te ri a X in Part XXX is all contained in Parts X and XX? but appears 
here in a condensed form so that you can euickXy locate something 
you n&ed* Experienced programmers who are used to learning new 

1 a n g u a g e s f r o m t e r s e 1 y w r i 1 1 e n m a n u a 1 s m a y w a n t t o s k. i m 1 :i. g h 1 1 y 
o v e r P a r t X a n d m a i n X y cons u X t P a r t X X X * X f y o u a r e c o n f u s e d 

a b o i j t w h a t a c o m m a n d doe s b y a d :i, s c u s s :i. o n i i"i P a r t X ? i t m a y h e X p 
to refer back and forth to both Parts X and XXX* 

This is a large manual* You may be daunted by the task of 
r e a d i n g a 1 1 o f i t b e f o r e b e g 1 n n i n g a n y w o r k w :i. t h X S K A T E ? b u t y o u r 
work, w i X X b e m o r e p X e a s u r a b X e i f y o u d o ♦ AX t h o u g h X S K A 7 E" m a y 
seem c o m p X i c a t e d ? i t i. s o n e o f t h e m o s t p o w e r f u X p i e c e s o f s o f t •- 
ware in the personal computer marketplace? and this complexity is 
a reasonable price to pay for the power you get* 
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Part IX USAGE 



1*1* Us i n g D I SKATE as a T e x t E d :i. t o r 



A text editor is one of the most crucial pieces of 
microcomputer software* It is through the text editor 
that you will prepare and maintain a good deal if not 
a 1 1 of the m a t e r i a 1 w o u r com p u t e r w i 1 1 d e a 1 w i t h ♦ 
D I SKATE (ATE stands for A Text Editor) has a variety of 
editing commands which can work with any type of text* 
The text is entered into and maintained in an area of 
the computer's memory called the SOURCE AREA* The 
Source Area is divided into one or more units called 
FILES* A file is simply a seoeunce of bytes in the 
memory » bounded by O's* Most of the editor's commands 
work with a file which is established as the CURRENT 
F 1 1.. E ♦ I f t h is file i s e x p <3 n d e d o r c o n t r a c t e d * t h e 
source area is expanded or contracted along with it to 
preserve all of the files in the source area* There are 
special commands which serve to make a different file 
the current file* Actually* you can have several 
different source areas in the computer's memory * but 
more about that later* To work with files that reside 
on the disk? you will need to move them in and out of 
memory using the DISKATE I/O commands * which are 
d i scussed i n I ♦ 3 ♦ 

W h e n y o u b r i n g u p D I S K A T E i t w i 1 1 i s s u e ■ > ■ a s a 
prompt character and wait for a command* There may be 
blanks between the name of the command and an argument 
if the command takes one* and blanks MUST be present 
between arguments if the command takes more than one* 
Usually in this manual we will omit unnecessary blanks * 
t h o u g h i n ' y o u r own w o r k y o u can i n c 1 u d e the m i f i t w i 1 1 
make the DISKATE commands more intelligible* A blank 
should never occur within an argument * unless that blank 
is a significant character as part of the argument* 

There are two key concepts which you will need to 
be fa m i 1 i a r wit h t o u n d e r s t a n d how the D I SKAT E c o m m a n d s 
work* The entry pointer and intervals* The ENTRY 
POINTER is a special 16 bit location pointing to a mem- 
ory location which serves as a kind of tarstet for where 
an action performed by many DISKATE commands is to take 
place* F o r i n s t a nee? 1 e t ' s c o n s i der o n e o f t h e s i m p I e s t 
DISKATE commands* which serves to enter text into a 
file* This command has the form* 



SOURCE 
AREA 

FILES 



CURRENT 
FILE 



> IS 

PROMPT 

CHAR 



ENTRY 
POINTER 



Eirtexta 



COMMAND 



(The E stands for Enter*) 
command you are typing in 



Note that if this is a 
all by itself* the prompt 
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character " > " w :i. 1 1 b e t h e f :i. r s t c h sracter o n t h e 1 :i. n e ♦ 

F o r i n s t a n c e y to enter t h e s t r i n si "I have a we a k s p o t 

f o r c o m p u t ersS the 1 :i. n e o n « o u r t e r m :i. i "i a 1 s h o u 1 d 1 o o k 
like: 

>ECI have a weak spot for computers! 

T o a v o i d c o n f u s i o n t h e p r o m p t c h a r a c t e r w :i. 1 "I. <$ e n e r a 1 1 y 
not be shown y since it is not one that you type* 

As you type in the characters of the text one by 
o n e 9 h e r e ' s w h a t D 1 8 K A T E w i '1. 1 d o * E v e r y t h i n <$ i n t h e 
c u r r e n t f i 1 e v a n d i n f a c t t h e w h o 1 e s o u r c e a r e a y s t a r t - 
ins with the location pointed to by the entry pointer? 
will in effect be pushed up in memory by one byte Bnd TARGET 

t h e c h a r a e t e r t w p e d w i 1 1 b e e n t e r e d i n t o t h e o a m p u t e r ' s C H A R 
memory at the location pointed to by the entry pointer* 
The entry pointer is then incremented* (Actually? this IB CHAR 
doesn't all happen character by character as you enter POINTED 
t h e E c o m m a n d y b u t e o n c e p 1 1. j a 1 1 y y o u c a n v i s u a I i s e i t T B Y 
t h a t w a y * > T h e E c o m m a n d t h u s i n s e r t s t h e t y p e d c h a r a c - E N T R Y 
t e r s i n t o t h e t e x t w i t h o u t o v e r w r i t i. n «.* ♦ T o s i m p I i f y P I N T E R 
thtnsi*>» let's think of the entry pointer as pointing to 
a c h a r a c t e r :i. n t h e f i I e ♦ T h i s c h a r a c t e r w i 1 1 b e c a 1 1 e d 
the TARGET CHARACTER* Uhen you enter text with the E 
o o m m a n d y t he t e x t i s I N S E R T E D i n t o t h e f i I e B ET W E E N T H E 
CHARACTER PRIOR TO THE TARGET CHARACTER AND THE TARGET 
CHARACTER* 

I... e t ' s I o o k a t a n e x a m p 1 e ♦ S u p p o s e t h e e »..i r r e n t f i 1 e E 
consists entirely of the characters* COMMAND 

INSERTS 
M y c o m p u t e r i s w e 1 1 f e d B E T W E E N 

TARGET 
w i t h t h e t a r «J e t c h a racier b e i n <?{ t h e M w " i n " w e 1 1 * ♦ C H A R 
(We'll 1 e a v e a s i d e f o r t h e m <:) m e n t t h e « u e s t i o n o f h a w i t A N D 
3 o t t h a t w a y ♦ ) Now s u p p o s e w e «* i v e t h e D I S K A T F" P R E v* 1 U S 

command* CHAR 

ETveryl 

The f i 1 e w i. 1 1 now c o n s i s t o f t h e a h a r a c t e r s ♦ 

My computer is very we 11 fed 

a n d the " w " i n " w e 1 1 ■ w i 1 1 r e in a i n t h e t a r $ e t c h a r a c t er? 
( t h o u «t h i t w i 1 1 b e i n a d i f f e r e n t p 1 a c e i n t h e c o m p u ~ 
ter's memory*) Because the "w" is the target character* 
the "very" sfoes between the "w" and the preoeedin** 
character* If I now enter the command* 

EC 1 

the file will consist of the characters* 
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M y c o m p 1..1 1 e r is very we 1 1 f e d 

The text entered with an E command can be any 
number of lines long (so Ion si as it fits into the area 
o f m e m o r y a 1 1 o c a t e d f o r t h e s o u r c e area!) B r a e k e t s a r e 
allowed within the text* but they must be balanced* For 
instance* 

F I" C o m p >. 1 1 e r s y I" o f c o u r s e » "I are c o in p 1 i c a t e d ♦ 3 

is a perfectly valid D I SKATE command* This entire 
s t r i n g o f c h a r a c t e r s w i 1 1 b e e n t e r e d 1 n t o t h e f i 1 e y 
i n c 1 u d i n g t b e b r a c k e t s ♦ Now? y o u a s k ? w h a t w i 1 1 h a p p e n 
i f b r a c k e t s a r e n o t b a 1 a n c e d ? T r o u b 1 e y d e a r u s e r ! I f 
you type* 

E I" o m p u t e r s » T o f 1 



ERROR 
MESSAGI 

I S " ? ■ 



t h i n k i n g t h a t t h i s w i 1 1 e n t e r t h e s t r i n g " C o m p i j t e r s y 

I" o f " t h e n t h e D I S K A T E c o m m a n d pr o e e s s o r w i 1 1 n ever h a v e 

received the closing right bracket which ends text 

entry* The result will be that you may think you are WONT 

t y p i n g co m m a n ds? w h e n i n f a c t w h a t y o u t y p e i s s t i 1 1 R E S P N D y 

b e i n g e n t ered i n t o t h e t e x t ♦ T h i s w i 1 1 g a r b a g e u p y o u r S T 1 1... I... 

f i 1 e w i t h what s h o u 1 d have go n e as c o m m a n d s ♦ W h e n y o u 1 N T E X T 

are typing in a command* check to make sure that the ENTRY? 

f i r s t character on the 1 i n e :i. s t h e p romp t c h arac t e r - 

" > " - - i f n o t y o u a r e p r o b a b 1 y s t i 1 1 i n t e x t e n t t v w ♦ 

T h e o p p o s i t e p r o b 1 e m ? t o o m a n y r i g h t b r a e k e t s * w i 1 1 
cause the text entry to be terminated prematurely* 
D 1 S K A T E w i 1 1 i n t e r p r e t the re s t o f t h e t e x t a s a c o m •- 
mand? which probably won't make sense* When D I SKATE 
gets a command that it can't make sense out off or an 
error occursn it w i 1 1 c o m e b a c k w i t h a e u e s t i o n m a r k ♦ 

W h a t if a p i e c e o f e d i t i n g r e e u i r e s t h a t y o u i n s e r t 
a string of characters with unbalanced brackets? There 
i s a w a y to do t h i s ? which for t he mo m e n t we' 1 1 p o s t - 
pone* the E command can also be used to enter numerical 
c o d e v a s w e 1 1 a s t e x t ♦ T h i s i s d i s c u s s e d i n s e c t i o n 
I * 2 * 

The text you enter with an E command may include 
ASCII control characters in addition to the carriage 
return* Some care should be taken in doing this* 
however y since such characters may not show on the 
terminal and could become hidden booby traps* When you 
type a carriage return during text entry? only the CR ONLY 
c a r r i a g e ret u r n c h a r a c t e r is e n t e r e d i n t o t h e f i 1 e y B E T W E E N 
though both a carriage return and line feed are echoed LINES IN 
back t o t h e t e r m i n a I * I f you are u s i n g D I SKAT E t o MEMORY 
prepare text to be used by another program? you may have 
to make sure that this program issues a line feed when 
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it encounters a carriage return* 

If you are entering characters for an E command* or 
any other command for that mattery and see a mistake on 
the current liner sou can type BACKSPACE to back up the 
cursor to the place where the error is* Each time you 
t y p © B A C K SPA C E y D I S K A T E w i 1 1 i g n ore t h e 1 a s t v a 1 i d 
c h a r a c t e r o n t h e 1 i n e v b a c k u p t h e c u r s o r a n d r e m o v e 
f r o m y o u r s c r e e n t h e o f f e n d :i. n g c h a r a c t e r ♦ Y a u ' 1 1 t h e n 
have to retype the rest of the line* Dry you can type 
ESCAPE <ESC) to tell D I SKATE to ignore the entire line* 
HI SKATE will echo the ESC with a backslash <"'\'>* If 
y o 1. 1 E S C a 1 i n e w h :i. c h b e g :i. n s a c o m m a n d y D I S K A T E w i 1 1 
e x p e o t a n e w c o in iyi a n d a n d w i 1 1 i s s u e t ft e p r o m p t c h a r a c •'•• 
ter* If you ESC a line of an E command which is not the 
f i r s t 1 i 1 "1 e ? t h e 1 i n e w i 1 1 b e i g n o r e d a n d y o u w i I 1 s t i 1 1 
be in text entry* 

As you type characters to D I SKATE y major changes in 
the memory do not occur until D I SKATE has received an 
e n t i r e I i n e * I n t h e m e a n t i m e w ft a t y o u h a v e t y p e d i s 
p I a c e d i n a s p e c :i. a 1 i n t e r n a 1 I o c a t i o n e a 1 1 e d a 1 i n e 
b u f f e r * T h e 1 e n «{ t h o f t ft i s b u f f e r 1 s 1 3 o h a r a e t e r s y 
which means that D I SKATE cannot process a longer line* 
T h i s s h o 1.1 1 d n o r in a 1 1 y c a u s e n o p r o b I e m s y s i n c e m o s t 
t e r m :i. n a I s h a v e a m a x i m u m 1 i n e I e n g t h o f S o r 1 e s s ♦ 1 1 
could show upy ho wo? very if you forgot to end a line with 
a carriage return and kept on going to the next line 
down on the screen* When the D I SKATE line buffer is 
fully the CURSOR WON'T MOVE* If this happens while 
y o u ' r e i n t h e m 1 d d 1 e o f t h e c ft a r a e t e r s f o r a n E c o m m a n d y 
you should type BACKSPACE and then a right bracket and a 
carriage return to terminate text entry to use other 
editing commands to place part of the lino? which is too 
long on the next line* 

I n a d d i t i o n t o t h i s I i m i t o n t h e m a x i m u m 1 e n g t h a 
1 i ri e c an ft e y D I S K A T E ft a s a n i n t e r n a I s e 1 1 i n g f o r t h e 
w i d t ft o f t h e 1 e r m i n a I ' s I i n e ♦ T h i s s e 1 1 i n g c a n b e 
changed by the user at any time* We won't discuss this 
a t t h e m o m e n t - ™ a f u 1 1 d i s c u s s i o n i s c o n t a i n e d i n s e e •••• 
t i o n 1*3 u nder t h e W I D c o m m a n d * 

Now that we have a basic idea of how text is 
e n t e r e d u s i n g D I S K A T E y a n i m p o r t a n t b u t s t i 1 1 v e r y b a s i c 
function is viewing the text to make sure that it is 
correct* There are a number of D I SKATE commands which 
serve this purpose* The simplest is the ' command y 
w h i c h w i 1 1 Q U T E N E I... I N E ♦ T h i s c o m m a n d w i 1 1 e a u s e t h e 
I i n e co n t a i n i n g the targe t c ft a r a c t e r t o b e p r i n t e d o n 
the terminal* The symbol "'"" (this prints as a carat on 
some terminals and as an upward arrow on older term in- 
a 1 s ) y w h i c h i s 1. .1 s e d i n D I S K A T E t o d e n o t e t h e e n t r y 
p o i n t e r y w i 1 1 a p pear e x e a 1 1 y w ft e r e a n y t e x t e n t e red w i t h 
an E command will go* That isy assuming the line has no 



BACK- 
SPACE 
IGNORI 
CHAR 
JUST 
TYPED 



ESC TO 
IGNORE 
WHOLE 
LINE 



TO 



CURSOR 
WON'T 
MOVE •»• 



LINE 
LONG 
TYPE 
BACK- 
SPACE 

::i 

CAR 
RET 



TOO 



COMMAND 

PRINTS 

LINE 

WITH 

TARGET 

CHAR 



i n v i s i b I e c o n t r o 1 e h a r a c t e r s y t h e 



w i 1 1 g o b e t w e e n 
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the target character and the preceding character* The 
' command has no arguments y and is a simple way to he 
sure the entry pointer is where you want it to he* It 
is highly recommended that you use this command often 
while you are first getting the hang of D I SKATE* It 
w :i 1 1 s h o w y o u e x c a t .1. y where t h e c hansfes y o u a re a ta o u t t o 

make will go • to the nearest line at least* To use 

the example from above* if the line with the target 
character is* 

M y c o m p u t e r i s well f e d 

with the target character being "w% giving the command 
' w i 1 1 p r i n t t h e I i n e * 

My computer is '"well fed 



b v i o u s 1 y we' 1 1 n e e d t o b e a b 1 e t o s e e m o re t h a n 
Just the line with the target character* The ■ command 
i s a m ore g e n e r a I c o m m a n d t h a t w i 1 1 I e t u s v i e w pr a c t i c - 
a 1 1 y a n y t h i n g ♦ The a r g u m e n t o f t h e " c o m m a n d i s a n 
INTERVAL in the computer's memory* This concept of 
interval is probably the most important one in DISK ATE* 
a n d s o w e ' 1 1 s p e n d s o m e t i m e w i t h i t ♦ The u n d e r 1 y i n g 
idea of an interval is extremely simple* an interval is 
a pair of addresses in the computer's memory* In order 
t o b e v a 1 i d for u s e b y D I S K A T E c o m m a n d s y t h e firs t 
address of the pair should not be larger than the second 
address* For instance y if we use the notation ddddU to 
refer to memory location dddd hexy the pair 2<>00Hy 2A00H 
i s a v a I i d i n t e r v a I y t h o u g h i t i s n o t yet i n a for m t h a t 
D I SKATE can recognize* It refers to all of the charac- 
ters in the memory from 2000H through 2A00H inclusive* 
This is why the first address must he less than or eraual 
to the second address — to refer to all of the 
characters from 2A00H to 2000H would not make sense* To 
return to the " command y this command takes an interval 
as its argument and prints on the terminal all the 
c h a r a c t e r s i n t h e i n t e r v a I y i s s u i n g a 1 i n e 
whenever it encounters a carriage return* 
examples we have to consider how intervals 
specified* 

The simplest way to specify an interval is to give 
e x p I i c i 1 1 y t h e p a i r o f a d d r e s s e s * F o r i n s t a n c e y the 
command* 



feed also 
To see some 
are 



INTERVAL 
IS A 
PAIR OF 
ADDRESSES 



COMMAND 

PRINTS 
INTERVAL 



2000H**2A00H 



will cause the characters in the interval from 2000H 
through 2A00H inclusive to be printed on the terminal* 
To give a complete explanation of the meaning of the ♦ ♦ 
symbol at this point would be prematurev so for the 
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moment let's leave it that an interval can he specified 
in the form* 

e x p 1 i o i t a d r e s s ♦ ♦ e x p 1 i o i t a d d r e s s 

N o r m a 1 1 y y o u w i 1 1 g i v e t h e a d d r e s s e s e x p 1 i c i 1 1 y w h e n y o u 
are using DISKATE more as a monitor than as an editor? 
s o t h e r e w i 1 1 b e in o r e a b o u t t h i s i n s e c t i o n I ♦ 2 ♦ 

A more sophisticated method of specifying an 
i n t e r v a 1 i s t o u s e a n a r g u m e n t t h a t c a 1 1 s f o r MAT C H I N G ♦ 
In using matching you present to DISKATE a pattern of HATCHING 
characters y an<:i it searches the memory looking for the 
pattern* If it finds it then the area that matches the 
p a 1 1 e r n b e c o m e s t h e i n t e r v a 1 ♦ A s i m p 1 e f o r in o f m a t o h i n g 
a r g u m e n t i s s i m i I a r t o o n e w e h a v e a 1 r e a d y s e e n w :i. t h t h e 
E command* The argument* f! TEXT 3 

GIVES 

i::text:i ist 

OCCUR- 
— w h e r e i n t h i s o a s e t e x t i s N T 1 o n g e r t ha n o n e 1 i n e R E N C E 
- •• • w i 1 1 m a t c h t h e f i r s t o c c u r r e n c e i n t h e curr e n t f i 1 e F C H A R S 
of the characters comprising text* OF TEXT 

For e x a m p 1 e » s u p p o s e t h e c u rre n t f i 1 e c o n s i s t s o f 
the characters* 

name! joan doe 
occupation: deer 
sex: female 
address: the woods 

The argument I" NAME "I denotes the interval in the memory 
o c c i..i p i e d b y the c h a r a c t e r s N y A y M y E i n t h e f i r s t I i n e o f 
t he file — wherever t h a t h a p p e n s t o b e ♦ No t e t h a t t h i s 
form of specifying an interval is CONTENT ORIENTED? in 
contrast to specifying the addresses bounding the inter- 
v a I e x p 1 i c i 1 1 w ♦ The a r g u m e n t I" N A M E "I w i 1 1 s t i 1 1 d e n o t e 
t h e first o c c u rrence of N y A y M v E i n t h e f i I e e v e n i f t h e 
file is changed so that something else occupies the 
memory locations that NyAyMvE once occupied* 

A n a r g u m e n t I i k e t*! N A M E 11 w i 1 1 d o u s 1 i 1 1 1 e g o o d a s 
a n a r g u m e n t for the " c o m m a n d y s i n c e t h e c o m m a n d ♦ 

tname:.! 

u i 1 1 s :i. m p I y p r i ri t NAM E o n t h e t e r m i n a I + Si m pie ar g u - 

ments of this form are very useful with other commands y 

however y as we'll see* What will be very useful with 

the " command y as well as others y is combining simple 

patterns such as T NAME "I using the operations DISKATE 

r e c o g n i z e s i n t o m u c h m ore c o m p 1 e x o n e s ♦ n e p o w e r f u 1 P A T T E R N :l. 

method is to use the ♦♦ construct y which we've seen in ♦♦ 

c o n n e c t i o n w i t h e x p 1 i c i t a d d r e s s e s ♦ The a r g u m e n t : P A T T E R N 2 
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cnamei ♦ * caddressi gives 

FROM 1ST 
r e f © r s t o t h e c h a r 3 c t © r s f r o in t h © f i r s t occ u r r © n c © :l. n P A T T E R N :l. 
t h © c 1..1 r r © n t s a u re© f i 1 © o f t h © char 3 c t © r s N r A 1 * M * E u p t o T 1 S T 
the first occurrecne AFTER the N*A»M*E of the characters PATTERNS 
AyDrDrRrErSrS "•-" so that the command* AFTER 

THE 
■ i: NAME I ♦ ♦ i: ADDRESS 1 PATTERN :l. 

w o 1.1 1 d p r :i n t o n t h © t © r m :i. n a 1 * 

NAME J JOAN DOE 
OCCUPATION* DEER 
SEX? FEMALE 
ADDRESS 

R © member t h a t :i. n 1 j s :i. n g ♦ ♦ i n t h :i. s wa»r i f t w o 
p a 1 1 © r n s a r © c o m b i n © d a s i n p a 1 1 © r n 1. * ♦ p a 1 1 © r n 2 9 D I S K A T E 
w :i. 1 1 1 o o k for t h © f :i. r s t o c c u r r © n c © o f p a 1 1 © r n 2 a f t © r 
p a 1 1 © r n 1 t o f i n d t h © u p p © r I :i. m i t o f t h © :i. n t © rva 'I. ♦ For 
i n s t a n c © v i f t h © c u r r © n t f i 1 © i s t h © s a m © a s t h © © x a m p !l. 0? 
«j b o v © 9 t h © c o m m a n d * 

"i:a::i. *i:a::i 

w o u 1 d p r i. n t o 1 "1 t h © t © r m i. n a I * 

AMEJ JOA 

I i"i m a n w © d :i. t :i n 3 a p p 1 :i. c a t :i. o n s i. t i s u s © f 1.1 1 t o view .... < U N D E R • 

t h © t © x t :i. n u n i t s of © n t i r © 1 i n © s ♦ There sr& s © v © r a 1 S C R E 

w a w s t o a c c o m p 1 i s h t h i s 4 T h 0? c h a r a c t © r " .... H — w h i c h R I... E F T 

prints as an underscore on most terminals Bnd as a POINTING 

left-pointing arrow on older terminals* is a matching ARROW 
argument which will MATCH A CARRIAGE RETURN ♦ For 

example* if w© ar& using the same current file as in the MATCHES 

examples abov©* the command* CAR RET 

B 1:: sex :i ♦♦.._ 

w i 1 1 p r i n t o n t h © t © r m i n a 1 * 

SEX J FEMALE 

The matching in this case works Just the way it <:iid in 
t h © F'VBKf i o u s u s e s of ♦ ♦ t a c o m h i n © i n t © r v a 1 s ♦ T h © 
a r g u m © n t C S E X 1 w i 1 1 m a t c h t h © f i r s t o c c u r r © n c © of t h © 
c h a r a c t ers S ? E * X i n t h © c u r r © n t f i 1 © ♦ T h © a r g u m © n t .., h s* 
its© If would match the first ooourrono© of a carriage 
return in the current filer so the argument I" SEX 1**... . 
w i 1 1 m a t c h t h e i n t e r v a 1 s t a r t i n g w i t h the f i r s t o c c u r - 
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r e n c e o f S ?EvX t h r o u g h t h e f i r s t carr :i. a g e r e t u r n a f t e r 
the SvEyX* 

The swmbol .... can also he used as an argument for 
the E command* The command J 



will enter a carriage return 9 Just as would the command ♦ 



CAN USE 
.... AS 

ARGUMENT 
OF E 
COMMAND 
TO ENTER 
CARRIAGE 
RETURN 



::i 

In manw cases it, is advantageous to use the .... symbol in 
an E command to have the command fit on one line* 

Suppose we want to see more than one line* To do OCCUR- 

this we can use the same symbol .... in connection with RENCING 
another operation supported bw DISKATE* OCCURRENCING* 

A n a r g u m e n t u s i n g o c c u rr& n c i n g g :i. v e s a n u m b e r n f o 1 1 o w e d n P A T T E R N 
b\A a pattern and matches THE NTH OCCURRENCE OF THE 

PATTERN* The argument 2... fow itself will match the 2nd MATCHES 

occurrence of a carriage return in the current file* nTH 

T h e a r g u m e n t 2 1" A 1 w i 1 1 m a t c h t h e 2 n d o e c u r r e n e e o f t h e C U R ■- 

character A* To continue with our same ex amp ley the RENCE OF 

c o m m a n d ♦ P A T t E R N 

h i::name::i**4... 

w i 1 1 p r i n t o n t h e term i n a I ♦ 
NAMEt JOAN DOE 

occupation: deer 
sex: female 
address: the woods 

Here the argument I" NAME "I ♦ *4... specifies the interval from 
the first occurrence in the current file of the charac- 
ters N>A»M*E through the fourth occurrence after the 
NAME of a carriage return* This will give us four lines 
from the c u rrG» n t f i 1 e beg i n n i n g w i t h t h e f i r s t o c c u r ~ 
rence of NvA^MvE* There are a couple of points to be 
noted here* Using an argument of the form n... as we ha\^e 
done w i 1 1 n o t g u a r a n t e e t h a t f i r s t 1 i n e of t h e res u 1 1 i n g 
i n t e r v a 1 i s t h e e n tire 1 i n e fro m w h i c h i t w a s t a k e n ♦ 
For instance* the command* 

"CI JOAN I** A... 

w o 1.1 1 d p r i n t o n t h e t e r m i n 3 1 * 



JOAN DOE 

occupation: deer- 
sex : FEMALE 
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ADDRESS J THE WOODS 

~ there is nothing in the argument IT JOAN 3 ♦♦ 4... which 

instructs D I SKATE to begin the interval with the begin- 
ning of a line* We'll see how to get entire lines in a 
minute* 

R e m ember that a c o n s t r u c t 1 i k e p a 1 1 e rn* ♦ n .... w i 1 1 
give you whatever matches pattern through the NEXT n 
1 i n e e n d i n g s * A common error i s t o ass u m e i t w i 1 1 t^ive 
you the interval from pattern to the n'th line ending in 
t h e c u r r e n t f i ley w h :i. c h i s n o t i n g e n e r a 1 w h a t w i 1 1 
happen* 

As we Just saw? we will often want to get entire SUFFIX 

lines* The easiest way to do this is with the % oper % 

ator* By adding the suffix % to an argument it will EXPANDS 
normally expand the argument to an entire line* The TO 
c o m m a n d * W H 1,. E 

LINE 

"i:\jo an ::i% 

u s e d w i t h o u r now w e a r y c u r r e n t f i 1 e w :i. 1 1 p r :i. n t o n t h e 
terminal ♦ 

NAME J JOAN DOE 

Now s u p p o s e we w a n t t o see 4 1 i n e s b e g i n n i n g with 
the first line containing JOAN* Here we've got to be 
car® f u 1 ♦ T h e c o m m a r» d ♦ 

"i:JOANl%* *4... 

will not give us what we want? but will give an error 
message ! To see why we have to keep at the business of 
going through exactly how D I SKATE will interpret the 
argument* The argument CJ0AN!3% is the interval consist- 
ing of the first line in the source file containing the PATTERN% 
characters J*Q»A>N* This INCLUDES THE CARRIAGE RETURN INCLUDES 
at the end of the line* The argument CJOAN'1%* *4... is the FINAL 
interval beginning with C JOAN 3% through the 4th occur- CAR RET 
vena® of a carriage return AFTER the C.'JOAN"l%* Since 
C JOAN 3% already includes a carriage return v in order for 
this argument to work there must be at least 5 carriage 
returns in the file? but altogether there are only 4* 
This explains the error message* The argument gave a 
pattern which DISKATE couldn't match* 

Occurrence. rig together with the % operator gives us 
a simple way to specify the n'th line in a file* For 
instance t suppose your terminal is a video terminal with 
24 lines* and you want to view your text in groups of 20 
lines — this way there will be a little overlap and 
room for DISKATE to issue the line with the prompt 
character* Suppose you want the 3rd such group* The 
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command* 

"n..%* *m ..% 

"41 %♦ ♦1.9....% 

GIVES mfl. 
w :i. 1 1 g i v e t h e d e s i r e d r e s u 1 t ♦ R e m e m b er once a g a :i. n t hat L I N E S 
i n a c o m m a n d of the f o r m * " n ... % ♦ * m .... % m w i 1 1. g :i. v e W I D T H S T A R T I N G 
~- that is the number of lines be ins* viewed? and not the WITH THE 
number of the final line to be viewed* Again note that nTH LINE! 
even though we want to see 20 lines* we have to use 1.9....% 

in the second part of the command because 41 % matches a 

whole line* If we had said "41 %**20....% this would give 

2 I !l. :i n e s v n o t 2 * Ac u t a 1 1 y * t h e f i n a 1 % . i n t h i s e o m m a n d 

is superfluous — "41 %**1. 9... will give exactly the same 

o u t p u t ♦ ( f c o u r s e v w i t h t h e J AN D E f i 1 e w e h a v e b e e n 
using as our standard example!' this command would return 
a n e rror m e s s a g e * s i n c e t h e r e a r e n ' t e n o u g h I i n e s i n t h e 

file to match even 4:1 %♦) 

S u p p o s e y o u w a n t t o s e e t h e 1 a s t I i n e i n t h e e u r - N E G A T I v" E 
r e n t f i I e b u t y o u d o n ' t k n o w how m a n w I i n e s i n t h e f i 1 e C U R - 
ther© are* This can be easily achieved using occurs err- RENCE 
cing with a NEGATIVE OCCURRENCE NUMBER* In an instance NUMBER 
of occur reneing of the form Npattern* if N is negative COUNTS 
D I SKAT E w i 1 1 1 o o k for t h e N t h o c c u r r e n c e o f p a 1 1 e r n B A C K W A R D 
COUNTING BACKWARDS EROM THE END 0E THE CURRENT EILE* FROM END 
The last line of the current file can be viewed by the OF FILE 
command* 

"•~1.....% 

At this point we should note that D I SKATE con- POS 
siders occurrence numbers to bo? SIGNED 1.5 BIT INTEGERS* OCCUR- 
That means that the high order bit is treated as a sign ENCE 
bit? and negative numbers are represented in two's NUMBER 
complement notation* On the other handy an address is MUST BE 
interpreted as a non-negative 16 bit number* When you <~ 
give D I SKATE a number 9 the Question of whether it will 32767 
be treated as a signed .1.5 bit number or a non-negative 
16 bit number defends on the context* If you ^iwe 
D I SKATE a negative number when it expects an address* 
the sign b i t w i 1 1 b e t r e a t e d as a d i g i t b i t * and i f y o u 
give a large number when it expects a signed number* the 
highest order bit will automatically be treated as giv- 
ing the sign bit* This means that an occurrence number 
greater than 32767 will count as a negative number* 
Th i s shou 1 dn ' t pose a p rob 1 em * s i nee it's very un 1 i ke 1 y 
you would ever need an occurrence number this large* 

What if you want to see the last 20 lines in the 
file? One way to do it would be by the command* 

"-20....%** 1.9....% 

This would literally give you 20 lines beginning with 
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the 20th line counting back from the end of the file* 
However there is an easier way* The command below maw 
throw you for a loop at first* because so far we have 
presented the symbol ♦ ♦ as an operator which connects 
i n t e r v a 1 s i n t o a 1 a r g e r i interval* I n f a c t t he ♦ ♦ s y m b o 1 
can itself be used as a pattern matching argument* The 
command we Just showed will give the same result as the 
s i nip 1 e r command * 

"•"20....%* * 

Let's see why this works* If you think of ♦♦ as an ** 

operator connecting two intervals? then the argument AS 

-20....%* ♦ would appear to be incomplete • the second MATCHING 

interval is missing* Instead of viewing * * as an ARG 

operator? it can be viewed as a MATCHING ARGUMENT WHICH MATCHES 

MATCHES ANYTHING* The argument -20....%** can be read as? ANYTHING 

the line containing the 20th carriage return 
b a o k f r o m t h e e n d o f t h e f i I e ? f o 1 1 o w e d b y 
anythin<3* 



B e c a u s e D I S K A T E is w o r k :i. n si w i t h t h e c u rre n t f i I e y t h e 
term "anything" is restricted in scope to the current 
f i 1 e ♦ N o t i c e a I s o t h e r e i s a o o n s t r u c t h ere w h i c h w e 
haven't seen before* a matching argument consisting of 
o n e p a 1 1 ern f o 1 low e d b y a n o t h e r p a 1 1 e r n ♦ T h i s i s c a 1 1 e d 
CONCATENATION* Writing one pattern di recti « after 
another specifies the pattern obtained by Joining the 
two patterns together* The pattern* 

CJ0AN3T DOE 3 

is exact I y equivalent to the pattern* 

TJ0AN DOE 1 



CONCAT- 
ENATION 



C o n c a t e n a t i n g two patter n s o f t h e f o r m C t e x 1 1 !1 C t e x 1 2 1 i s 
not very useful? because instead you could Just use the 
p a 1 1 e r n C t e x 1 1. 1 e x 1 2 1 ♦ C o n c a t e n a t i o n i s v e r y i m p o r t a n t ? 
however? when the two patterns are specified by differ- 
ent means* A pattern of the form t! text 3- specifies the 
pattern consisting of text followed by a carriage 
return* There is no way to specify this pattern directly 
in the form C!text.'1 because a pattern of this form cannot 
extend accross more than one line* 

You can also use concatenation with the E command* 
For instance? the command* 

E.... I." TABLE XI... 

would enter first a carriage return? then the characters 



CAN USE 
CONCAT- 
ENATION 
WITH E 
COMMAND 
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T 9 A 9 B » L jEs'J? a n d t h e n a n o t h e r e a r r :i. a g e r e t u r n * 

If * ♦ is a iti a t c h i n g sr^ u m © n t * t h e n how s h ou 1 d w e 
interpret the command* 



PRINTS 
? Literally it would mean » print "anything" on the ter •• ENTIRE 
m i n a .1. ♦ R e m e m ta e r y t h o u g h 9 t h a t a n y t h i n g i s r e s t r i e t e d i n C U R R E N T 
scope to the current file* Thus the command "♦* will FILET 
PRINT THE ENTIRE CURRENT FILE ON THE TERMINAL* Suppose 
w e w a n t t o s e e ever y t h :i. n g a f t e r t h e 3 5 1 h 1 :i. n e ♦ T h e 
command* 

avJ..,. * * 

w :i. 1 1 d o w h a t w e w a n t ♦ Ac u t a 1 1 y y t o b e c o m p 1 e t e I y p r e 
c i s e t h i s :i. s n o t « u i t e o o r r e e t y s :i. n c e t h i s w :i. 1 1 g :i. v e u s 
t h e 3 5 1 h c a r r :i. a g e r e t u r n f o 1 1 o w e d b y a n y t h i n g * S e e i n g 
t h i s e x t r a c a r r i a g e r e t u r n a t t h e b e g i n n i n g w i 1 1 n o t d o 
u s a i"i y h a r m y o f c o u r s e y b u t a n a r g u m e n t e r r o r 1 i. k e t h i s 
can be very serious with other commands* To get exactly 
w h a t we w a n t w e s h o u 1 d r e a 1 1 y u s e t h e c o m iri a n d * 

"36....%** 

since the interval consisting of "everything after the 
3 5 1 h 1 i n e " i s t h e s a m e a s "ever y t h i n g s t a r 1 1 n g w i t h t h e 
3 6 1 h 1 i n e " ♦ 1 1 i s a f r e (a u e n t b u t i n e s c a p a b I e n u i s a n c e 
in many areas of programming to worry about whether 
s o m e t h i n <3 s h o u I d b e n a r n + 1 ♦ 

S i m i I a r 1 y t o s{ e t t h e f i r s t 5 1 i n e s o f t h e o u t^ r e n t 
f i 1 e y t h o u <s h the c o m m a n d " ... % * * A .... % w o u I d w o r k y a s 1 m p I e r 
command is* ■ * *n,... 

"**5... GIUES 

1ST n 
I... i t e r a 1 1 y t h e a r <-i u m e n t ♦ ♦ 5 .... m e a n s " a n y t h i n .<# y f o 1 1 o w e d b y I... I N E S 
t h e !5 1 h c a r r i a «{ e r e t u r n " * 

Now is the t i m e t <:» c o n f e «> s t o a 1 i 1 1 1 e w h i t e 1 :i. e * 
So far- in this manual we have seen the use of the symbol 
♦ ♦ bo t h as a n o p e r a t i o n f o r c o m b :i. 1 "1 i n ti i n t e r v a 1 s y a n d a s 
a matching argument* In facty instead of ♦♦ you can use » 
any number of dots from one on up --- so» for example the ♦* 
argument pattern! *pattern2 has the same meaning as ♦♦♦ ETC* 
p a 1 1 e r n 1 ♦ ♦ p a 1 1 e r n 2 o r p a 1 1 e r n :l. * * ♦ p & 1 1 e r n 2 ♦ L e t ' s s e e 
why this "ambiguity" causes D I SKATE no problems* The ALL HAUE 
actual symbol which D I SKATE recognizes internally is the THE SAME 
single dot* Since ♦ can be interpreted as a matching MEANING 
a r g u m e n t which m a t c h e s a n w t h i n g y ♦ ♦ c a n b e t h o u g h t o f a s 
a m a t c h i n g a r g u m e n t w h i c h m e a n s * a n y t h i n g f o 1 1 o w e d b w 
anything* Clearly this has the same meaning as Just 
plain anythingy which is why any number (greater than 
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zero) of dots amounts to the same thins* The use of two 
dots here is s imply personal preference* A si rustle dot 
taw itself in an argument is easy to missy which is why 
t w o bvb b e i n g u s e d in t h i s m a n u a 1 y b u t i n « o u r own w o r k 
wou should use either one* two or three dots together as 
your preference suits* 

We've seen so far that specif wing an interval which 
m a t c h e s a g i v e n 1 i n e n u m ta e r 9 o r a g i v e g r o u p o f 1 i n e s 
i d e n t i f i e d b w 1 i n e n u m b e r 9 ca n be s 1 i g h 1 1 w t r i c k w ♦ 
DX SKATE provides a waw to deal with numbered lines 
d i r e e 1 1 w w h i e h e 1 i m i n a t e s s o m e o f t h i s d i f f i c u 1 1 w 9 b u t 
which is not as general in building complex expressions* 
The swmbol ! is similar to X in that it refers to an n! 

e n t i r e 1 i. n e 9 b u t r a t h e r t h a n b e i n g a g e n e r a 1 s u f f i x 
w h i c h c a n b e a p p e n d e d t o a n w a r g u in e n t y t h e s w m b o 1 ! i s S P E C I 
only placed after an occurrence number to spec if w the FIE8 
n ' t h 1 i n e i n t h e c u r r e n t f i 1 e ♦ S p e c i f i c a 1 1 w t h e T H E N'7 H 

srsfument* LINE 

DIRECTLY 
n ! 

- NO 

s p e e i f :i. e s t h e n ' t h 1 :i. n e i n t h e c u rr& n t f i 1 e ♦ T h i s i s MAT C H I N G 
NOT A MATCHING ARGUMENT* When evaluating n\ 9 DISKATE 
searches thro u g h t h e o u r r e n t f i 1 e f o r t h e n ' t h 1 i n e 
w i t h o u t r e g a r d t o a n w t h i n g e 1 s e * I... e t ' s s e e h o w t h i s 
c o m p a r e s t o o u r p rev i o u s e x a m p 1 e s * 

Above we saw an example of a " command using 
expressions of the form n..,.X for showing 20 lines 
b e g i i"i n i n g w i t h 1 in© 41* T o d o t h i s u s i n g t h e ! s w m b o 1 
we could use the command* 

"4i!**60! 

N o t i c e h o r e t h at 60! is n o t a m a t c h i n <3 a r g u m e n t y s o i t 
d e f i n i t e 1 w d o e s n o t m a t c h t he 60 1 h 1 i n e a f t e r t he 41 s t 

1 i n e ♦ I n s t e a d ? 60! s i m p 1 w s p e c i f i e s t h e 6 1 h 1 i n e 

p e r i o d y n o m a 1 1 e r where t h e . e x p r e s s i o n 6 ! o c c 1..1 r s ♦ 

The ! is very useful when you want to see specific 
n u m b e r e d 1 i n e s i n a f i 1 e y b u t n o t a s u s e f 1. .1 1 w h e n w o u 
w a n t t o s P e c i f w 1 i n e s r e 1 a t i v e t o a c o n t e i"« t o r i e n t e d 
a r g u m e n t ♦ We saw f o r • i n s t a n c e 9 t h a t the c o m m a n d J 

8 cjoan::i%**3.._ 

w i 1 1 p r i n t o n t h e t e r m i n a 1 f o u r 1 i n e s b e g i n n i n g w i t h t h e 

f i r s t o (^ e u r t % e n c e i n t h e c u vvb n t f i 1 e o f J A N W I -I E R E v* E R 

that happens to be* The command* 

-i:joan:i%**3! 

w o 1. j 1 d give an error m e s s a g e i f t h e f i r s t o c c u r r e n c e o f 
JOAN happened to be bewond the '3rd line in the current 
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file* Even thoush it maw seem like more work at first 
to learn to specify intervals us ins expressions of the 
form n....%v because these expressions can be used more 
w 1 d e 1 y t h a n e x p res s i o n s 1 i k e n ! i t ' s a S o o d i d e a t o S o 
to the extra effort* 

There is another important way in which expressions 
o f t h e f o r m n ! d :i. f f e r f r o in e x p r e s s i o n s 1 i k e n ....%* W e s a w 
t h a t t h e a r si u m e n t - :l. .... % r e f e r s t o t h e 1 a s t 1 i n e i n t h e 
o u r r e n t f i 1 e y the e x p r e s s i o n - 2 .... % t h e n e x t t o t h e 1 a s t 
line? and so on* In evaluating expressions of the form 
n!y DI SKATE will TREAT ALL OCCURRENCE NUMBERS AS POSI- 
T I U F ♦ 1" f y o u s p e c i f y n ! a n d t h e r e a r e n o t n 1 i n e s i n 
t h e f i lev n ! w i 1 1 e v a 1 u a t e t o t h e a d d r e s s o f t h e w h i o h 
f o r m s t h e u p p e r b o u n d o f t h e f i 1 e i n t h e c o m p u t e v ' s 
m e inory* Soy - 2 ! w :i 1 1 n o t S i v e t h e n e x t t o t h e 1 a s t 1 i n e 
i. n t h e c u r r e n t f i 1 e » b u t w i 1 1 S i v e t h e a ddve s s o f t h e 
at the end of the file? as will --3! and so forth? since 
- 2 i. s t h e s a m e t h i n S a s 6 5 5 3 4 y w h i c f i 1 s s u r e 1 y 1 a r S e t v 
than the number of lines in the file* This means that 

-1 ! 

is a convenient expression for the at the end of the 
o u r r e n t f i 1 e ♦ We'll h a v e o c c a s :i. o n t o n e e d t h i s ♦ 

S i n c e D 1 S K ATE pr o \/ide s t h e f a c i 1 i t i e s f o r r e f e r r i n si 
to locations in the current file by line number? in more 
than one way in fact? you misht wonder if there is a way 
for DI SKATE to provide you with the numbers of the lines 
i n t h e c u r r e n t f i 1 e ♦ T h e r e i s i n d e e d a way? ta u t we' 1 1 
p o s t p o ri e a d e t a :i. 1 e d d i s c u s s i o n u n t i 1 s e o t i o n 1 ♦ 4 b e e a u s e 
it is keyed to the assembler* To Jump the Sun a bit* 
t h e P c o m m a n d i s s i m i 1 a r t o t h e " c o m m a n d a n d w i 1 1 p r i n t 
t h e i n t e r v a 1 S i v e n a s a r & u m e n t w i t h 1 i n e n u m ta e r s ♦ H o w •- 
every if you Si ve this command with a file consisting of 
ordinary prose text? THE TEXT WILL COME OUT IN A PECUL- 
IAR FORMAT with all kinds of spaces where they shouldn't 
be* The P command is designed to print assembler source 
o o d e y a n d t h e s p a c 1 n S i s s o t h a t t h e I i s t i n S w i 1 1 e o n - 
f o r m t o a c o n v e n i e n t a s s e m b 1 e r f o r m a t ♦ I f y o u 're a ta I e 
t o r e c o S n i z e I i n e s p r o p e r 1 y i n s p i t e o f t h i s f o r m a t y y o u 
c a n u s e t h e P c o m m a n d t o o ta t a i n I i n e n u m b e r s f o r u s e i n 
e x p r e s s i o n s I i k e n .... X a n d n ! * T h e u s e o f I i n e n u in b e r s 
obtained in this way is a very Sood way of makin?-* sure 
that an occurrence of a pattern is in the ris-Sht place* 

1 1 m a y s e e m t h a t w e ' v e b e e i"« s p e n d i n «i a n u n d u e 
amount of time with the " command* D I SKATE has many 
m o r e c o m m a n d s t h a n J u s t t h e o n e s w e ' v e d i s c u s s e d s o f a r * 
The reason for spending so much time with the " command 
;i. s t o d e v e I o p t h e c o n o e p t s a f i n t e r v a I y m a t c h i n S y a n d 
many of the ways that intervals v.ran be specified' by 
us ins for illustration a command which simply shows us 
the interval in Question* Although we are not finished 



n! 

TREATS n 
POSIT I ME 

IF TOO 
BIG 
GIVES 
ADDRESS 
OF 
AT END 
OF FILE 

-1 ! 

GIVES 
AT END 
OF FILE 
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with seeins new operations by which you can combine 
i n t erva 1 s ? p e r h a p s n ow's t h e t i in e t o b e g i n :i. n t r o d u c i n g 
some more commands* Before doing this I should 
emphasize as strong !l.y as possible that if you are ever 
i n d o u b t a s t o J u s t w h a t i n t e r v 3 1 a n a r & u m e n t a c t u a 1 1 w 
specifies? it's always best to give D I SKATE! a " command 
and see* 

So far the D I SKATE commands we've discussed have K 
been concerned with two kinds of operations J entering COMMAND 

t e x 1 ? a 1 "1 d v i e w i n g t e x t a 1 r e a d y e n t e r e d ♦ A n o t h e r :i, in p o t 

tant maJor operation involved in editing is DELETING KILLS 
t e x t * I n D !l! S K A T E t h i s i s a c c o m p 1 ;i. s h e d b y t h e K c o m ••- < D E L E T E S > 
mand? which will KILL* or delete? the interval given as INTERVAL 
the argument* Let's go back to our standard ex amp lost 

name? joan doe 
occupation: deer 
sex j female 
address; the woods 

S u p p o s e we w a n t t o m a k e t h e f o 1 1 o w i n g c h a n g e s ? w h i c h 
b o t h i n v o 1 v e o n 1 y d e I e t i o n s * t h e n a m e J AN i s t o b e 
changed to JON and FEMALE to MALE* Let's do the second 
one first* What we want to do is delete the FE from 
FEMALE* It happens in this case that the only occur- 
rence of EE in the file is in FEMALE? so the command* 

KLFE!!I 

will do what we want* But!!! Remember that the argu- 
ment CFE3 specifies the FIRST occurrence of the charac- 
ters F?E in the file* How do we know for sure that this 
f i r s t o c c u r r e n c e i s i n t h e r i g h t p 1 a c e ? f c o u r s e v i n 
this case the whole file is small enough that we can 
look and see? but even then it is possible to make a 
mistake* The best thing to do is ALWAYS USE A " COMMAND 
TO MAKE SURE THE INTERVAL YOU GIVE IS THE ONE YOU WANT* 
If we were being careful we would have said; 

"l!!FE!3% 

and D I SKATE would have responded with* 

sex; female 

Then we would have the confidence that the KTFE!!I command 
would do what we intend* When you give a K command? the 
only thing that will be printed on the terminal is the 
prompt character when D I SKATE is ready to accept another 
command unless the argument you give involves match- 
ing and D I SKATE cannot find anything that matches? in 
which case an error message will be printed* If we're 
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being as cautious as possible)' perhaps we ought to take 
a look after the K command to make sure everything looks 

the way we want it - this is after all the goal of text 

e d i t i n si ♦ T h e s i m p 1 e s t w a y t o si e t a « u i e k 1 o o k i s t o u s e 
the ' command* If we give the command ' right after the 
K I" F E "I c o m m a n d y t h e n D 1 8 K A T E w i 1 1 p r :i. n t o n t h e t e r m i n a 1 * 

SEX? "MALE 

Let's take a careful look at this* Remember that 
the ' command prints the line with the target character? K 

putting the sum bo 1 ' between the target character and COMMAND 

t h e p r e v i o u s e h a r a e t e r - - i * e * e x a c 1 1 y w h e r e a n y t e x t S E T 8 
e n t e r e d w i t h a n E c o m m a n d w o u 1 d b e i n s e r t e d ♦ I 1 ' s b e e n T A R G E T 
a while since we mentioned the target character and its CHAR ;::: 
cohort the entry pointer* The " command does not affect 1ST CHAR 
the entry pointer* but the K command will SET THE ENTRY AFTER 
POINTER* After a K command? the TARGET CHARACTER WILL INTERVAL 
BE THE FIRST CHARACTER AFTER THE INTERVAL DELETED* DELETED 
That's why the M " H is in front of MALE in the line shown 
above* This setting of the entry pointer can be both 
useful Bnd also cause severe difficulties if not kept in 
mind* 

T h e d i f f i c u 1 1 i e s c a n a r i s e b e c a u s e i t f r e o «..i e n 1 1 w 
happens that you want to enter some text? then make some 
changes using the K command v snd then go on to enter 
more text* Beouase the K command resets the entry 
pointer y if you're not careful to put the entry pointer 
where you want ity the text you enter thinking it is 
g o i n g a t t h e e n d o f t h e f i I e w i 1 1 a c t u a 1 1 y b e <•* o i n g i n t o 
the middle* The reason D I SKATE resets the pointer* how- 
eve r y i s t h a t a K c o m m a n d f o 1 1 o w e d b y a n E o o m m a n d w i 1 1 
REPLACE the deleted interval by the text given with the 
E c o m m a n d y w h i c h :i. s e x t r e m e 1 y u s e f u I ♦ T h e s e t w <:) e o n s i •- 
derations bvb very important y but in order to see some 
iti o r e e x a m p 1 e s o f u s i n g t h e K e o m m a n d v w (••> ' 1 1 p o s t p o n e a 
d e t a i I e d d i s c «. i s s i o n ♦ 

Now let's do the second change we hBd plarirmdi 
chBn^iin<-i JOAN to JON* In this case what we n&Bd to do 
is delete the A from JOAN* Before getting involvedy 
let's give a "♦♦ command and see what the file looks 
1 i k e ♦ I n res p o n s e t o ■ * * D I S K A T E w i 1 1 p r i n 1 1 

name? joan doe 
occupation: deer- 
sex: MALE 
address: THE WOODS 

Ri&ht away we can see that to simply say KTA"| would be 
trouble* The first occurrence of A in the file is in 
the word NAME? so KCA.1 would delete the A from NAME* 
which is not at all what we want* One approach would 
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be to trw to count the number of A's in the file before 
the one we wants* so we could specify the right one by 
using ooeurreneing* In this case the A in JOAN is the 
s e c o n d A i n t h e f i ley so t h e c o m m a n d ♦ 

K2CA3 

will in fact do what we want* But this method has real 
difficulties* First of ally we can hardly find out 
using a " 2TA1 command whether we've got the right 

occurrence of Ay since "2CA3 will only print A not 

t e 1 1 i n g u s W H I H A i t ' s p r i n t i n g ♦ n e w a y t o r e m e d y 
t h i s w o i..i 1 d b e w i t h t h e c o m m a n d * 



T h i s w o u 1 d p r :i. n t t he w h o 1 e c u r r e n t f i 1 e u p t o t h e 2 n d 
occurrence of Ay which would be a way to make sure that 
t h e 2 n d A i s r e a 1 1 « w h a t w e w a n t ♦ B u t y a m o r e s e r i o u s 
p r o b 1 e m w i t h t h i s a p p r o a c h i s t h a t i n a 1 o n g f i 1 e y i t 
would hardly be convenient to have to count occurrences 
.Just to specify the one we want* At this point we are 
really getting to the whole crux of using DI SKATE as a 
text editor* Because matching is content oriented* it 
a 1 1 o w s u s t o d o s o m e i n c r e d i b 1 y p o w e r f u 1 t h i n g s y b «..i t a t 
the same time we have to take some care to be sure that 
when an interval is specified by matching it is the one 
we want* Although this particular change is simple y and 
we've a 1 r e a d y s e en o n e w a y t h a t w i 1 1 w o r k y 1 e t ' s 1 o o k a t 
several different methods that will be very helpful in a 
great variety of situations* 

Let's suppose for the moment that we can be confi- 
dent that the JOAN in which we want to delete the A is INITIAL 
t he f i r s t o c c u r r e n c e o f J A N i n t h e f i I e ♦ Her e y o f R E F E R - 
c o u r s e y we can be b e c a i. j s e t h e f i 1 e i s s o s i m p I e ♦ The EN C E 
thing that we want to do is* delete the A in JOAN* INTERVAL 
D I SKATE has a construct which reflects exactly this 
meaning* We ha\/e said repeatedly that in determining GIVES 
intervals using matching arguments* D I SKATE works with THE 
t he c i. j r r e n t f i 1 e ♦ A c t u a 1 1 « t h i s h a s b e e n a n o v e r s i m p I i - S C P E 
float ion which normally does no barmy but at this point OF 
we need to be more precise* Whenever an argument MATCHING 
involves matching* before the argument is evaluated 
D I S K A T E r e s t r i c t s t he s c o p e o f t h e a r <$ u m e n t t o a n 

INITIAL REFERENCE INTERVAL* For most commands this (USUALLY 
initial reference interval is the current filer which is CURRENT 
w h y o u r p r e v i o u s over s i m p 1 i f i c a t i o n i s n o r m a 1 1 y n o t F I L E ) 
misleading* D I SKATE has a special operation which 
a 1 1 o w s y o u t o i n effect set the i n i t i a I r e f e r e n c e 
interval to something else* Whenever D I SKATE encoun- 
ters a ! in evaluating an argument y THE INITIAL REFER- 
ENCE INTERVAL FOR THE REST OF . THE ARGUMENT IS THE ! 
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?Rv*AL CORRESPONDING TO THAT PART OF THE ARGUMEN 
ADY EVALUATED* The easiest way to understand 
I. be by example* * 

T h e a r g u m e n t I" A 1 w :i. 1 1 y t o b e p r e e i s e y m a t o h t 
>t occurrence of A in the initial reference int 
? h :i. s n o r m a 1 1 w t h e o u we n t f i 1 e ♦ T h e a r g u in e n t 
I. match the first occurrence of JrOrArN in the 
I. r e f ere n c e i n t er^/a 1 y w h i c h i s n o r m a 1 1 y t h e c u r 
•> ♦ T h e a r g u m e n t I" * J A N 1 ! I." A 1 w i 1 1 m a t c h t h e f i r s 
i r r e n c e o f A W I T H I N t h e f i r s t o c c u r e n c e o f J y y 
i n i t i a 1 r e f e r e n o e i n t e r v a 1 y n o r m a 1 1 y t h e o u r r e 
♦ The command* 



this 


SETS 




INITIAL 


■he 


REP* 


erval y 


INTERVAL 


CJ0AN1 


FOR REST 


i n i - 


OF ARG 


rent 


TO' PART 


t 


OF ARG v 


A 9 N i n 


TO LEFT 


fit 


OF : 



KCJ0AN3 JCA3 

w i 1 1 a c h i eve e x a c 1 1 y w h a t we w a n t - - p r o v i d e d v o f 
course? as we mentioned)' that we are sure that the JOAN 
in Question is the first occurrence of JOAN in the 
current file* 

I n a I a r g e r f i I © » h o w e v e r y we w o u I d s t i 1 1 h a v e t h e 
General problem of making sure that we were in the right 
p 1 a c e f o r a o h a n s e ♦ J n t h e s a m e w a « t h a t w e s a w b e f o r e y 
i s s i. j i n is " C J A N "I ! I" A "I o r e v e n " |" J A N "I w i 1 1 n o t t e 1 1 u s w e 
are making the change in the right placer because it 
w i 1 1 n o t t e 1 1 u s w h i c h o c c i. t i r r e n c e o f ,.J AN we a r e I o o k i n g 
a t ♦ I... e t ' s s u p p o s e t h a t we h a v e a f i I e i n w h i c h we w a n t 

to make exactly this same change deleting the A from 

an occurrence of JOAN? but there are many occurrences of 
JOAN in the file and we want to be very careful to de<~ 
1 e t e o n 1 w t h e r :i. g h t o n e ♦ T h e c o m m a n d * 

"♦♦CJO'AN.1 

w i 1 1 p r i n t ever y t h i n g i n t h e o u r r e n t f i I e u p t o t h e 
first occurrence of JOAN* Suppose this is not the right 
one* and we want to print the rest of the file up to the 
next JOAN* One way of doing it would be* 

tjoan:i* *2tjoan:i 

T h ere" s n o t h i n g w r o n g w i t h t h i s y b u t i f t ft i <;» i s n o t t h e 
right JOAN either y we would fta\/e to be keeping track of 
t h e o c c u r r e n c e n u m b e r ♦ H e r e i s a c o m m a n d t h a t y o •..« c a n 
keep on issuing successive times to see the intervals of 
t e x t b e twee n s u c c e s s ;i. v e J A N ' s ♦ 

">**i:joan:i 



This command uses a feature we haven't seen before* 

So far the only time we have encountered the character GIVES 

">" is as the prompt character* D I SKATE recognizes UPPER 

this symbol as a special argument which does not involve ADDRESS 
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matching* > denotes the upper address of the LAST IN- IN 

TERVAL COMPUTED BY DISKATE* Since we Just got through LAST 

w i. t h t he com m a nd " ♦ ♦ C * J A N 3 ? i n t h :i. s c a s e > w i I 1 ta e t h e I N T E R V A I ... 

address of the N in the first JOAN in the file* The COMPUTED 
a r g u m e n t > ♦ ♦ then w i 1 1 m a t c h eve r y t h i n g i n t h e c u r r e n t 
f :i. 1 e f r o m t h e N i n t h e f i r s t J AN onw a r d ♦ 

There is an important but subtle point here that we 
should note before going on* In all the cases we have 

s e e n ? D I S K ATE ar g u m e n t s are i n t e r v a I s •• i ♦ e ♦ a p a i r S I N G I... E 

of addresses* But here we've Just said that > denotes ADDRESS 

the upper address in the last interval computed by EQUIVA- 

DISK ATE* This implies that > denotes not an interval LENT TO 

but a single address* In fact? any symbol or expression INTERVAL 

in D I SKATE that determines a single address is also WITH 

interpreted as AN INTERVAL WHOSE UPPER AND LOWER ADORES- UPPER 

SES ARE EQUAL* We said that an interval was a pair of AND 

addresses in which the first address was not greater LOWER 

t h a n the second* b u t t h e y c e r t a i n 1 y may b e e a u a I ♦ F o r A D D R E S S 

example? in evaluating arguments DI SKATE takes the THE SAME 
expression* 

2000H 

to be completely equivalent to the expression* 

2000H**2000H 

Note that this last makes perfect intuitive sense* 

Now let's return to the example* We started with 
the command ■ ♦ ♦ C JOAN 3 ? and could see from it that the 
first occurrence of JOAN was not the right one* What we 
said we wanted to do? then? was view the rest of the 
f i 1 e t o t h e n e x t J A N ♦ u r comma n d " > ♦ ♦ C J A N 1 w i 1 1 d o 
exactly that? with a minor bit of nuisance* This com- 
mand will print the interval from the N in the JOAN we 
Just saw to the next occurrence of JOAN* If this JOAN 
is not the right one either? we can type exactly^ the 
same command? ">♦ ♦ CJOAN!!! ? and keep on typing it? to see 
the consecutive intervals of text prior to successive 
JOAN's* Actually? as we'll see at the &nd of section 
I ♦ I ? t h e r e i s a s p e c i a 1 c o m m a n d e a 1 1 e d D E F w h i c h i s very 
useful in exactly this kind of situation where we want 
to keep giving the same command repeatedly* The DEF 
c o m m a n d w i 1 1 a 1 low , j u s t c a r r i a g e r e t u r n t o i n v o k e a 
special default command* 

The minor bit of nuisance referred to is the fact 
that the N from the last JOAN we looked at will begin 
the printout* (We'll see in a minute how to get rid of 
that*) The second time we type ">**CJ0AN!3 the symbol > 
will be the upper address from the last interval compu- 
ted? w h i c h i n t h i s c a s e w i 1 1 be t he N fro m t h e s e c o n d 
occurrence of JOAN* Each time we type the command? a 
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n © w i n t &rva I w :i. 1 1 h a v © ta e © n c o m p u t © d v s o t h © v a 1 u © o f > 
will change* Not© that to use this method v ■ yo u must not 
us© any other command between the instances of 
■ > ♦ * C J A N 1 y s :i. n c e a n i n t © r v © n i n g o o m m a n d w i 1 1 p r o b a b I y 
cause an interval to be computed * so that > will not 
hav& the value we want it to* 

A f t © r h a v i n «* t y p © d i n t h © o o m m a n d " > ♦ ♦ I" J A N "I e n o u g h 
time si* w© should com© to th© JOAN w© want* But now 
there is a problem* We want to kill' th© A in the JOAN 
in the interval we Just saw ••-•••• but how do we specify it? 
There ar-B different possible app roaches y but' here is a 
s i m p 1 e o n © w h :i. o h w i 1 1 s h o w a n o t h © r f © a t u r © o f D I S K A T E 
we haven't seen before* Tn the interval that we Just 
computed y w© can be absolutely sure that there is only 
on© occurrence of JOANv since w© set things up so that 
the command ">♦ ♦ CJOANI is showing us the interval of 
text until the NEXT occurrence of JOAN* What we want to 

do is delete the A in the JOAN and w© know there is 

o n 1 y o n © — :i. n t h © i n t © r v a 1 ,. j u s t e o m p u t © d ♦ T h © f o 1 1 o w - 
i n g o o m m a n d w i 1 1 d o © x a o 1 1 w t h a t * 

Kir:joAN:i!A 

I... © t ' s t a k © t h i s c a r e f u 1 1 y * T h © f i r s t t h i n g w © s © e i n 
t h i s c o m m a n d i s K y w h i c h i s t h © s y m ta o 1 f o r t h © K i 1 1 
command* The very next character in th© command is a ! * 
We hav© said that I caus©s the part of the argument 
a 1 r e a d w g i v e n t o b e o o m © t h e i n :i. t i a 1 r e f e r © n c e i n t e r v a 1 ♦ M 1 8 S I N G 
B u t her© w © h aven't g i v © n a n y a r g u m © n t w © t a t a 11! W h a t A R G U M E N T 
w © ' r © s © o? i n g i s a n © x a m p 1 © o f a n © x t r © m © 1 y u s e f u 1 
D I SKATE feature* IF A COMMAND REQUIRES AN INTERVAL AS USES 
ARGUMENT? AND NO ARGUMENT AT ALL IS GIVEN* THE ARGUMENT PREVIOUS 
USED IS THE PREVIOUS INTERVAL COMPUTED* INTERVAL 

So* Th© letter K says that this is a kill command* COMPUTED 
and what follows is to b© the argument* The ! says to 
t a k e t h a t p a r t o f t h e a r^ u m e n t a 1 r © a d y c o m p u t © d a n d u s © 
it as th© initial reference interval* Sine© no argum©nt 
thus far has been given* the ! immediately after the K 
w i 1 1 c a u s e t h © i ri :i. t i a 1 r e f e r © n c e i n t © r v a 1 t o b © t h & 
p r © v i o i..i s i n t Br\/a I e o m p u t © d * T h a t i n t © r v a 1 » r © m © m b © r y 
w©nt from the N in th© JOAN before the on© w© want? to 
the next JOAN? which is the one from which we want to 
d © I © t © t h © A * S o 9 t h © a r g u m © n t u p t h r o u g h ! C J A N "I 
specifies the first occurrence of JOAN in the previous 
interval computed!* which is Just the JOAN w© want* Th© 
next ' sets this? that is the JOAN? as the initial 
referBncB interval v so that the total argument 
! C J0AN1 ! C A.1 specifies * 

t h © A w i t h i n t h © f i r s t J A N w i t h i n t h © p r © v i o u s 
interval computed before this command is executed* 
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s :i. s 
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n on 
eate 
mate 
We 
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RESS 
e wa 
erva 
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e x a c t .1. y w h at we w a n t » s o t he K ! C J A N 1 ! C A .1 d o e s 
ok* Note that this is an example of using more 
e ! in a single command* You can use the ! 
dly in this way to keep narrowing down the scope 
hing to set what you want* 

saw that the symbol > can be used to give the 
ddr ess of the last interval computed by DISK ATE* 
s a corresponding symbol which denotes THE LOWER 

OF THE LAST INTERVAL COMPUTED: < * Here are 
ws this can be used* Suppose you Just saw an 
I using a " command? and it didn't amount to a 
i n e y a n d y o u w a n t t o s e e t h e 1 i n e c o n t a i n i n g t h i s 
1* The command* 



<% 



will do the trick* Notice that the command* 



GIVES 

THE 

LOWER 

ADDRESS 

OF THE 

LAST 

INTERVAL.. 

COMPUTED 



w 1 1 1 n o t work* The ! r i g h t a f t e r the H sets t h e i n i t i a I 
reference interval to the last interval computed v so the 
whole a r g u m e n t ! ♦ ♦ .... m e a n s t h e firs t 1 i n e o f t h e I a s t 
interval computed* But the last interval computed did- 
n't co n t a i n a n e n t i r e 1 i n e v s o t h i s c o m m a n d w :i. 1 1 g i v e a n 
error* The ! o p e r a t i o n a 1 1 o w s y o u t o specif y a n i n t e r v a I 
w i t h a g i v e n i n t e r v a I v b u t there c a n ' t b e a n w o v e r I a p ♦ 
With < and > you can see intervals that do overlap the 
last interval computed* The command* 

•'. ♦ ♦ v> .... 



will show you thr 
acter of the last 
h appp ens to be a 
only two lines* ) 
w h e t h e r the p r e v i 
lines or not* 

Care must be 
since its value w 
ed* < is ASSIGNED 
OF THE INTERVAL I 
everything in the 
of the last inter 
command ♦ 



e e 1 i n e s be g i n n i n g wit h t h e f i r s t c h a r •••• 
i n t erva 1 c o m p u t e d ♦ (If t h a t c h a r a c t e r 

carriage return you will appear to see 
It doesn't matter one way or the other 

ous interval computed contained three 



taken in using < in complex arguments? 
ill change as the argument is evaluat-- 
A VALUE AS SOON AS THE LOWER ADDRESS 



< GIVEN 
VALUE AS 
SOON AS 
S DETERMINED* So 9 if you wanted to see LOWER 

ADDRESS 
OF 

INTERVAL 
IS DETER- 
MINED 



current file up to the first character 
val computed v you could NOT use the 



since as soon as D I SKATE sees the ♦ ♦ it knows the lower 
address of the interval to be computed will be the 
beginning of the current file* < is then assigned this 
value? so the argument ♦♦< spec if es only the first char-" 
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acter of the current file* The value of < can change 
several times as a single argument is evlauated* For 
instance* in the argument* 

ITJOAN3ICA3 

< is first set to the address of the J in the first 
occurrence of JOAN in the file* and then set to the 
address of the A within that* An argument with several 
instances of ! maw cause < to be reevaluated several 
times during a single argument* 

A v a 1 u e i s n o t a s s i g n e d t o > u n t i 1 e i t h e r t h e w h o 1 e > G I v" E N 

argument is evaluated or a ! is encountered* So* the VALUE 

a r g u m e n t ♦ U H E N 

WHOLE 

i:joan:;ii> arc 

EUAL •• 
specifies the N in the first occurrence of JOAN in the UATED OR 
current file* If you are in doubt about what < or > AT ! 
should mean* give HI SKATE a simple test case using a " 
command to see the result* 

Above we saw how we could see successive intervals 
of text ending in the next occurrence of JOAN* but men- 
t i o n e d t h a t b w u s i n g t h e c o m m a n d " > ♦ ♦ I..' J A N 3 t h e f i r s t 
character printed would be the N in JOAN* It certain ly 
does no harm to keep having this N printed* since this 
is only a " command* but it would be nice to know how to 
get rid of it* It's always good practise to be able to 
s p e c i f y precise 1 « t h e i n t e r v a 1 we w a n t * b e c a u s e a s 1 i g h t 
n u i s a n c e s u c h as t h i s i n i t i a 1 N c o u 1 d t u r n i n t o a s i g n i •- 
f i c an t e r r o r w i t h o t her c o m m a n d s + T h e i n t e r v a 1 > ♦ ♦ I" J A N !.l 
includes everything we want to see* but what we want is 
t he char a c t e r s f r o m t h e i n t erva 1 > * ♦ C J A N "I s t a r t i n si w i t h 
the first character after the initial N* The command 
below will be an effective replacement for the 
" > ♦ ♦ C J A N 3 e 1 i m i n a t i n g the 1 n i t i a 1 N p r o b 1 e m ♦ 1 1 
introduces a new matching symbol which we haven't seen 
before* 

">**cjoan:3!2(»** C» 

The symbol ® will match ANY SINGLE CHARACTER* As MATCHES 

a n a r g u m e n t a 1 1 b y i t s e 1 f i t m a t c h e s t h e f i r s t c h a r a c t e r ANY 

i n t h e i n i t :i. a 1 r e f e r e n c e i n t e r v a 1 ♦ I n t h e c o m m a n d S 1 N G I... E 

above y the argument to the left of the ! is exact ly what CHAR 
we used before 9 so let's look at the part to the right 
of the ! ♦ 2© matches the 2nd occurrence of the pattern 
®» or the 2nd occurrence of any character* In other 

words* 20 matches THE 2ND CHARACTER in the initial n(? 

r e f e r e n c e i n t e r v a 1 * . 2 <? ♦ ♦ t h e r e f o r e m a t c h e s ever w t h i n g MAT C H E S 

in the initial reference interval start in. g with the 2nd THE 

character* I f we're u s i n g t h e c o m m a n d a b o v e a s a n T H H A R 
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replacement for the ">♦ ♦ C!JOAN!;i * before the command above 
is given* the last interval computed will presumable be 
the interval of text starting with the first character 
after an occurrence of JOAN* or the first character in 
the current file if we are Just starting out 4 So* 
> ♦ ♦ C J A N 1 w i 1 1 m a t c h ever w t h i n si fro m the N i n t h e c u r - 
rent JOAN to the next JOAN* The ! sets this as the ini~ 
t i a 1 r e f e r e n c e i n t e r v a 1 * s o the a r g u m e n t > ♦ ♦ T J A N 3 ! 2 ♦ ♦ 
becomes everything starting with the second character 
WITHIN* the interval from the N in the current JOAN 
through the next entire JOAN* This is exactly what we 
want — the same interval we were getting before? but 
w i t h t he fir s t char a c t e r t r i m m e d o f f ♦ 

Here's a different kind of example that shows how 
you can use the ! operation together with the $ matching 
symbol* Suppose the file you are editing is a program* 
a n d y o u want a n a r g u m e n t w h i c h w i 1 1 m a t c h t h e f i r s t 
occurrence of a variable name* let's say BUFFER* which 
occurs at the BEGINNING OF A LINE* To say that it 
occurs at the beginning of a line means either that it 
w i 1 1 b e t h e v e r y f i r s t t h i n g i n t h e f i lev or e 1 s e i t 
will be immediately r^ receded by a carriage return* To ...PATTERN 
s i m p 1 i f y t h i n g s 1 e t ' s s u p p o s e we c a n r u I e o u t t h e f i r s t ! 2 ♦ ♦ 
p o s s i b i 1 i t y ♦ Here's t h e a r g u m e n t t h a t w :j. 11 work* 

MATCHES 
.... i: BUFFER 1 ! 28 * ♦ PATTERN 

AT 
The argument ...T! BUFFER 3 matches the first occurrence of a BEGIN- 
carriage return followed by the characters B*U*F*F*E*R* NING OF' 
s o t he w h o 1 e a r <$ u m e n t m a t c hes ev e r w t h i n g f r o m t h e 2 n d L I N E 
c h a r a c t e r o n w i t h i i "i t h e f i r s t o c c u r r e n c e o f a c avr i a g e 
r e t u r ri f o 1 1 o w e d b a BUFF E R ♦ T h a t i s * t h e a r g u m e n t 
matches the everything in ...I" BUFFER 3 after the carriage 
return* which is what we want* 

Let's return now to our example of deleting the A 
in JOAN and see another way it can be done* Recall that 
the last way we did it* we ended up marching through the 
whole c u r r e n t f i I e u s i n g " co m m a n d s u n t i I w e f o u n d t h e 
right JOAN* But suppose we could be sure we ft ad the 
r i g h t J A N J u s t by s e e i n g t h e I i n e c o n t a i n i n g i t ♦ 
Here's an approach where we only view a line at a time* 
which will introduce a new D I SKATE command that is very 
important to keep in mind in conjunction with the K 
command* We recall that the ' command is a simple com- 
mand with no argument that will show us the line with 
the target character* and the position of the target 
character in the line* What we're going to do is set 
the entry pointer to successive JOAN's and use the ' 
command to view the line with the target character* 
until we get the right JOAN* Then we can go ahead and 
use the K command* The first step is to set the entry 
pointer to the first JOAN in the file* This is 
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accomplished with the command* 

T JOAN 3 COMMAND 

We encountered the symbol ""■ before • — D I SKATE SETS 

prints this symbol between the target character and the TARGET 

preceding character in response to a ' command* When CHAR 

used as a command * '" SETS THE ENTRY POINTER TO THE LOWER TO 

ADDRESS IN THE INTERVAL GIVEN AS THE ARGUMENT* That is* FIRST 

the "* command sets the target character as the first CHAR OF 

character in the interval given as the argument* In INTERVAL 

t h :i s o a s e * C J A N "I m a t c h e s the f i r s t o e o u r r e n c e o f J A N G I V E N A S 

i n t h e f :i. 1 e * so t h e " x f '. J A N 1 c o m m a n d s e t s t h e e n t r w A R 0) U M E N T 
pointer so that the J in this JOAN becomes the target 
c h a r a c t e r ♦ N o w i f we g i v e a ' c o m m a n d a n d t h e t a r g e t 
character is the J in the wrong JOAN* the command* 

">♦♦ ic:joan:.i 

will set the J in the next JOAN to be the target charac- 
ter* Asia in we can give the ' command to see the line 
with the target character to check to see whether we've 
got the right spot* Note that because the ' command 
does not take an argument* the symbol ">" has the same 
value after the ' command as before it* What command 
shall we use once we have the right JOAN? There ar& 
s e v e r a 1 d i f f e r e n t c o m m a n d s we c o u I d u s e t h a t w o u 1 d a 1 1 
have the desired effect* As before* 1 Kl CJOAN3 I CA3 would 
do* Or* since we know that the target character is the 
J in the JOAN we want* we could use the command* 

k~**ii::a:i in 

argument 

I n t h i s c o m m a n d we s e e s t i 1 1 a n o t h e r u s e of t h e 
s w m b o I " ~ ■ ♦ T he c o m m a n d i s a K i 1 1 c o m m a n d * s o M "* " i s MA T H E S 
not used here as a command* Rather* ""*" is used here as TARGET 
part of an argument* The swmbol ""*■ used as an argument CHAR 
gives AN INTERVAL BOTH OF WHOSE ADDRESSES ARE THE VALUE 

OF THE ENTRY POINTER* Or* you can think of ■ as a 

SYMBOL WHICH MATCHES THE TARGET CHARACTER* So* the 
a r g «. j m e n t i n t h e c o m m a n d a b o v e * t r a n s I a t e d 1 i t e r a 1 1 w * 
m e a n s t h e f i r s t A w :i. t h i n ever w t h i n g i. n t h e c i j r t % e n t f i I e 
star t i n g w i t h t h e t a r g e t o h a r a c t e r * S i n c e we a I r e a d y 
arranged for the target character to be the J in the 
JOAN from which we want to delete, an A* this command 
will work* 

In fact there is a command for deleting the A in 
JOAN in this situation which is even simpler* When we 
used the "* command to set the target character to be the 
J in successive JOAN's* we also set the last interval 
computed to be the whole JOAN* So* bw the time we've 
f o u n d the r i g h t J A N we w i 1 1 k n o w t h a t t h e 1 a s t i n t e r v a I 
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computed wil 
is* 



1 be this JOAN* All we need to say* then* 



km::a::i 



The ! before any argument is giv 
reference interval to the last i 
is the correct JOAN* and within 
A - — the only A in fact • — is Ju 
delete* Note that if we use thi 
t i o n * t h e m a i n f u n c t i o n o f hav i n 
to be able to see where we were 
is often not a bad idea to use t 
even when you bvb not sure wheth 
target character to be set to th 
a r g u m e n t i n o u e s t i o n ♦ 

Perhaps this is the time to 
feature of DISKATE* So far we h 
pies of DISKATE commands one by 
give DISKATE an ENTIRE LINE OF C 
SEPARATED BY COMMAS* Rather that 
commands ♦ 

">♦♦ 1TJ0AN.1 



en sets the initial 

n t e r v a I c o m p u t e d * w h i c h 

this interval the first 

st what we want to 

s command for the dele- 

g used the " % command was 

using the ' command* It 

he ~ command this way* 

er you will need the 

e f i r s t char a c t e r o f t h e 

m e n t i o n a n i m p o r t a n t 
ave been giving exam- 
o n e ♦ Ac t u a 1 1 y * y o u c a n 
OMMANDS at Once 

g i v i n g two s e para t e 



MULTIPLE 
COMMANDS 
ON ONE 
LINE 
SEP- 
ARATED 
BY 

COMMAS 
ARE 
ALLOWED 



it's easier to put both commands on a single line* 
">** ICJOAN:!*' 



B y n o w i t s h o u Id be c 1 e a r t h a t there w i 1 1 a 1 m o s t 
always be many different ways of accomplishing a given 
t h i n g in DISKATE* a n d a f t e r u s i n g i t f o r a w h i 1 e y o u 
will surely develop your own style* The examples 
presented here reflect the style of the author of this 
manual • — a style which you may not care for once 
DISKATE becomes familiar* One of the things that has 
been stressed above* and will be stressed below* is that 
you should always look before you leap — give DISKATE a 
" command or ' command which will preview any change you 
are about to make* Constantly giving such viewing com- 
m a n d s may see m t e d i o u s * b u t they w i 1 1 save a n e n o r m o u s 
amount of grief that can result from giving an erroneous 
command* 

We've seen many examples of various simple dele- 
tions — deleting an A from an occurrence of JOAN to 
change it to JON* The deletion itself was usually easy? 
but the work came in specifying where it was to take 
place* Now let's suppose we wanted to change the JOAN 
instead to JOHN — deleting an A from JOAN and inserting 
an H* Without repeating all of the previous examples* 
let's suppose we have set things up* by various " 
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commands perhaps* so that in the last interval computed 
the first JOAN is the one we want to change* We saw 
t h a t t he co m m a n d t 

km::joan:i ja 



will, delete 
the H* As m 
Set chsrscte 
val. deleted* 
target char a 
deleted the 
E command? a 
aoters of it 
the precedin 
now the N in 
immediately 
in JON and t 
in JON* Thi 
The command ♦ 



the A from this JOAN* Now we want to add in 
entioned above? the K command sets the tar- 
r t o b e t h e f i r s t c h a r a c t e r a f t e r t h e i n t e r - 

A f t e r t h e c o m m a n d K 1 1 J A N "I ! A ? t h e n ? t h e 
eter will, be the N in the JON* (We Just 
A*) To insert the H we will want to use an 
nd remember the E command inserts the char- 
s operand between the target character and 
S character* Since the tar Set character is 

JON? anything entered with an E command 
a f t e r t h e K ! I" J A N "\ ! C A :i w i 1 1 s o b e t w e e n t h e N 
h e p r e v i o u s c h a r a c t e r ? w h i c h w i 1 1 b e t h e 
s is exactly where we want to put the H* 



K!i::joan:i{|.:a:i?ei::h:i 

w i. 1 1 replace the A i n t h e J A N w i t h a n H i n a s i n S I e 
c o m in a n d ♦ I n S e n Bra 1 ? K i n t e r v a 1 ? E C! t e x t "I w i 1 1 R E P I... A C E t h e 
characters in the interval with text* 

At this point we come to what is possibly the 
Greatest single potential source of error in ordinary 
D I SKATE usase* Regardless of whether you want to use an 
E command to replace with new text an interval which has 
been d e 1 e t e d w i t h a K c o m m a n d ? t h e K c o m m a n d w i 1 1 s e t 
the entry pointer so that the tar set character is the 
f i r s t c h a r a c t e r a f t e r t h e d e 1 e t e d i n t e r v a 1 ♦ 1 1 
freouently happens in us ins* a text editor that you will 
enter some text? discover an error perhaps? So back and 
make a chanSe? and then resume enterinS more text* Here 
we ha^/B a problem* Any chanti® in the file made us ins 
the K command will reset the entry pointer* If we don't 
somehow save the value of the entry pointer before the 
chanSe is made? and then restore it after makins the 
chanse? when we So back to enter ins text we will be 
enter ins it in the wronS place* How do we Set the entry 
pointer back to where it was before we made the change? 
As usual there are so? vera 1 methods* 

Perhaps the safest method is to save the value of 
the entry pointer and then restore it* This can be done 
us ins a DI SKATE feature we haven't seen before* 
variables* A D I SKATE VARIABLE is named by a strinS of 
characters beSinnins with a letter? and containing only 
upper case letters and disits* Variable names can be of 
any lensth* When you brinS up DI SKATE certain variables 
i..i s e d b y the a s s e m b I e r w i 1 1 a I r e a d y h a v e v a I u e s ? a n d 



K 

FOLLOWED 
BY E 

REPLACES 

KILLED 

INTERVAL 

WITH 

ENTERED 

TEXT 



TO 

RESUME 

TEXT 

ENTRY 

AFTER 

MAKING 

CHANGES? 

ENTRY 
POINTER 
MUST BE 
RESTORED 
i i i i i i i i 



VARIABLE 



LETTERS 
% DIGITS 
STARTING 
WITH 
LETTER 
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should not be changed unless you are certain you will 
not be usinsf the assembler* These variables arei 

Ay By Cy Dy Ey Hy l...y My SP y PSW 

A variable can be assigned a value us in si the : ~ command y 
which has the form* 



VARIABLES 
USED BY 
ASSEMBLER 



v a r i a b 1 e ™ a r g u m e n t 



COMMAND 



In this case there MUST NOT BE A BLANK between the = UAR»"ARG 

sign and the variable name* since if there were D I SKATE SETS 

would interpret the variable name as the name of a VARIABLE 

command* There cany how every be blanks between the ™ TO LOWER 

sign and the argument if you like* The argument can be ADDRESS 

any D I SKATE argument y and the variable is given the OF ARG 

value of the LOWER ADDRESS of the interval specified by INTERVAL 
the argument* So> if you art-? going to make some changes 
in text you have Just entered with the E command y and 
want to save the entry pointer 9 you can use the command 

ENTRY"" 

and then when you want to restore the value of the entry 
pointer give the command* 

"ENTRY 



Note that the " command does not use an ™y and 
automatically assigns the value of the lower address of 
the argument to the entry pointer* (In fact "-ENTRY 
would give an error message y since " is not an ordinary 
variable*) The choice of "ENTRY" as the name of the 
variable is of course arbitrary y and you may want to use 
shorter names* Be careful y though 9 about using single- 
letter names* If we used the variable E instead of 
ENTRY y this could cause real problems since E is one of 
the variables used by the assembler* Whenever you are 
ready to begin entering text after having made some 
changes y it's always a good idea to *SivB a ' or " com- 
mand to make sure the entry pointer is where you want it 
to be* If you make a change y fail to restore the entry 
pointer* and then resume text entry y you may find your 
text looking much more botched up than it was before wou 
made the change* 

Variables can also be used as occurrence numbers* 
We saw above examples of how to march through your file 
seeing successive instances of a given text pattern* 
Another way to do it is using variables for occurrence 
numbers* Suppose for instance that your file is a list 
of lines* each one having a similar format to* 
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NAME: JOAN DOE 

occupation; DEER 
sex j female 
address: the uoods 

and you wanted to patie through successive entries* To 
do it using variable occurrence numbers y begin with the 
command! 

X=i 

Then to see the newt entry you can use the command* 



e the pattern matching 
ich specifies an absolute 
ack to this method is 

Xi:NAME:i* *4... D:i:SKATE must 
from the beginning each 
it tie slow* 

e d b e f o rev s o i t ' s w o r t h 
hat it does* On the 
pear s s t r a i g h t forw<3r d - 

of X* However y D I SKATE 
1 s y a n d a s i n g 1 e n u m b e r 
h addresses are the same* 
9 so we should clarify 
t e r v a 1 ♦ A n a r g u m e n t o f 



"xi:name:i* *4....yX~xfi. 

Note once again that we must us 
symbol .... here rather than ! y wh 
line number* One slight drawb 
that in evaluating the argument 
search the entire current file 
time y so it will tend to be a 1 
The + we haven't encounter 
taking a minute to understand w 
surface a command like X-X+1. ap 
it simply adds one to the value 
arguments are generally inte rva 
is simply an interval where bot 
•f can be used with an\^ argument 
what it means with a general in 
the form* 

argfvalue 



is evaluated by adding value to BOTH addresses of arg* 
In our standard example* for instance? the command* 

"i:name:3+i 

w i 1 1 p r i n t A y M v E y s p a c e o n t h e t e r m i n a 1 ♦ A r i t h m e t i c 
o p e r a t i o n s y o u c a n u s e are + y - » >K y a n d / w i t h t h e i r 
usual meaning* Division will give only the Quotient 
d i s card i n g t h e r e m a i n d e r y an d m u 1 1 i p 1 i c a t i o n w i 1 1 g i v e 
o n 1 y t h e 1 o w or d e r 1. 6 b i t s o f t h e ( p o s s i b 1 y ) 3 2 b i t 
product* However y these operations are carried out left 
to right with the same priority y so that for instance 

1+2*3 

evaluates as 9 rather than 7 as it would in a typical 
BASIC* As with +y all of the arithmetic operations 
operate on both values of an interval argument* 

Let's see some ways these operations can be used* 



ARG1. 
•f 

/ 
ARG2 

PERFORMS 
OPERA- 
TION ON 
BOTH 
ADDRES- 
SES OF 
ARG1. 
WITH 
LOWER 
ADR OF 
ARG2 



AR1TH* 
OPS 

EVALU- 
ATED 
LEFT TO 
RIGHT 
SAME 
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S u p pose y o u w a n t t o s e e the f :i. r s t 1 c h a r a c t e r s o f t h e P R 1 R I T Y 
last interval computed by DISK ATE* One way to do it 
would be by the command* 

■ !♦♦!<>(? 

This would say* print everything up to the 10th charac- 
ter within the last interval computed* Another way 
would be* 

*<**<+9 

T h i s in e t h o d d o e s n o t a c t u a 1 1 y c a 1 1 f o r a n y m a t o h i n g ♦ 1 1 
s a y s t o p r i n t t h e 1 n t e r v a 1 f r o m t h e 1 o w e r a d d r e s s o f t h e 
last interval computed through 9 more characters* 

Suppose you wanted to advance the entry pointer by ""'"♦fn 
one character* The command* 

ADVANCES 
""HI ENTRY 

POINTER 
will do the Job* Likewise ""-1 will back it up by one n CHARS 
character* Many other uses of the arithmetic opera- 
t i o n s w i 1 1 show u p w h e n u s i n g D 1 S K A T E a s a m o n i tor which 
we ' 1 1 see i n Sect i on 1 ♦ 2 ♦ 

Let's return to the problem of restoring the entry TO ADD 
pointer after changes have been made so that text entry TEXT TO 
can continue in the proper place* There is one problem THE END 
with the method of saving the value of n with a variable QP THE 
and then restoring it* What if you have made some PILE 
changes? with a K command say? but suddenly don't remem- 
ber whether you saved the value of /n or not? It would TARGET 
be useful to be able to put the entry pointer in the CHAR 
right place regardless of what you did before* For tun- MUST BE 
a t e 1 y i t ' s easy to spec i f w w h e r e t h i s p 1 a c e w i 1 1 u s u a 1 1 y H A R 
be* If you want to go on entering new text after AFTER 
changes have been made in what has already been entered > LAST 
the new text should go at the END of the current file* CHAR IN 
Because the E command Places text between the target THE FILE 
character and the preceding character? to add text to 
the end of the file you want the target character to be 
THE CHARACTER AFTER THE LAST CHARACTER IN THE FILE* How 
can we specify this? The argument ♦♦ specifies the 
c u r r e n t f i 1 e ♦ T h e a r & u m e n t ♦ ♦ ! > s p e c i f i e s the « j p p e r 
a d d r e s s of the c u r r e n t f i I e .* s i n c e t h e ! ca u s e s a n e w 
value to be assigned to >* The address we want is one 
higher t ban ♦ ♦ ! > ? so the c o m m a n d * 

w i 1 1 p u t the en t r w po i n t e r so t h a t a n y t e x t entered w i t h 
the E command will go at the end of the file* 

There is a subtle point here which may cause some 
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confusion* In 3 1-1 of the previou 
stressed that ! allows us to spec 
argument WITHIN an argument* Her 
violated this* In the argument ♦ 
specifies a location which is out 
the left of the ! * How can this w 
that > is evaluated directly by c 
DISKATE location WITHOUT ANY MATC 
evaluated the argument as far as 
h a p p e n e d v a m o n g o t h e r t h :i. n g s * 



ex a 

f y i 
we 
{>+! 
ide 
rk? 
nsul 
ING* 



tuples 
n ess 
seem 
9 the 
of th 

The 
ting 

Whe 
here 



w 
en 
to 

p 
e 

an 
an 
n 
:i. s 



e ' ve 
ce an 

have 
art >+ 
part * 
swer i 

inter 
D I SKAT 

what 



♦ to 
s 

nal 
E has 
has 



1 * T h e i n :i. t i a 1 r e f e r e n c & i n t e r v a .1 :i. s s t :i. 1 1 t h e c u r r e n t 

file* 

2 * < h a s bee n a s s i g n e d t h e a d d r e s s o f t h e f i r s t c h a r a c • 

ter in the file* 



ARG1 I 
ARG2 

WITH 

ARG2 NOT 
INSIDE 
ARG1 



WILL. 

WORK 

ARG2 

NO 

MATCHING 



IF 
HAS 



3* > has been assigned the address of the last charac- 
ter in the file* 



After these have taken place? the value of >f:l. can be 



c a 1 c i j I a t e d d i r e o 1 1 y ♦ 



1 i e s o u t s i d e t h e i n i t i a I refer e n c e i n t e r v a 1 v a n w m o r e 



than it matters that at 
lie outside the initia 

There 
tuted for 



t doesn't matter that this value 



i e x p 1 i c i t a d d r e s s 1 i k e 2 A H m a y 

. r e f e r e n c e 1 n t e r v a 1 ♦ 

is an alternative symbol which can be substi- 

♦ in this example* The symbol <F> is an 



a r g i..i m e n t w h i c h o a 1 1 s f o r n o m a t c h i n g a n d d e n o t e s t h e 

c u r r e i "i t f i 1 e ♦ T h e c o m m a n d w e J u s t s a w c a n b e t^ e p 1 a e e d ta y 

the command* 

'XF> !>"+! 



DENOTES 
CURRENT 
FILE 

NO 

MATCHING 
WHATEVER 
I NIT REF 
INTERVAL 



T h e r e i s a n i m p o r t a n t d i f f e r e n c e * * * d o e s n o t r e a 1 1 y 
spec i f y t h e c u r r en t f i 1 e v b u t r a t h e r t h e i n i t i a I "* < F > ! > -f 1. 

reference interval y as we have discussed* There is a 
s fee i a 1 D I S K A T E c o m m a n d w h i c h we w i 1 1 d i s c u s s b e 1 o w S A F E 
which can be used to manipulate the initial reference COMMAND 
interval 9 thus changing the meaning of ♦♦ — but <F> TO PUT 
a I w a y s r e f e r s t o t h e o u r r e n t f i 1 e t n o m a t ter w h a t t h e E N T R Y 
initial reference interval is* % PTR AT 

The command that we've Just seenv ~<F>i>+l» is END OF 
probably the command that comes the closest to specify- FILE 
in si the end of the file within the D I SKATE language in a 
s t r a i g h t f o r w a r d w a y ♦ T h e a r g u m e n t < F > ! > + 1. m a y I o o k c o n •••• 
f u s i n g f b i,.i t i t H s a y s ■ t h e e n d o f t h e f i 1 e o u i t e d i r e c t ••- 
1 y ♦ However? t h ere i s a s i m p 1 e r c o m m a n d w h i e h w i 1 1 work 
b y a s ide e f f e c t ♦ W e r e c a 1 1 f r o m a p r e v i o u s d i s c u s s i o n 
t h a t - 1. ! w i 1 1 a 1 s o s p e c i f w t h e e n d o f t h e c u r r e i "i t f i 1 e ♦ n ••- 1 ! 
The simplest command for setting the entry pointer to SIMPLEST 
t h e e n d o f t he f i 1 e w h i e h :i. s r e 1 i a b I e i s p r o b a b I y t he C M M A N D 
command* TO PUT '*' 
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"~-1. ! 

If you use this command in preference to ~<F>!>f:l. r be 
very sure you don't confuse ! for %♦ 

There are simpler commands which will set the 
entry pointer to the end of the current filer and 
we'll see them later* but they reeuire you to be 
certain that particular circumstances obtain and so 
can lead to errors* Probably the safest command to 
use is either **<F>!>+i or "-I ! ♦ 

Once again r it cannot be emphasized strongly enough 
that you MUST absolutely restore the entry pointer 
before resuming text entry if you make changes in text 
already entered* Failing to do this will mean the new 
text you enter will be <^oin^ in the wrong place!!! 

But suppose the worst does happen? and you find 
that you have a large block of text in the wrong place* 
Of courser this can happen Just because you change your 
mind about how you want the text to look even if you've 
made no mistakes in using D I SKATE* Moving text is one 
of the key components of editing r and DISKATE has a 
simple move command* The M command? M for mover will 
move the characters in the interval specified by the 
argument and insert them the same place text entered 
with an E command would go* between the target charac- 
ter and the preceding character* Let's look at an 
example* Suppose the current file consists of* 

name? john doe 
occupation: deer 
sex j male 



AT 
OF 



END 
FILE 



M 
COMMAND 

MOVES 

INTERVAL 

GIVEN AS 

ARGUMENT 

AND 

INSERTS 

PRIOR TO 

TARGET 

CHAR 



ADDRESS 



THE WOODS 



and suppose we want to move the line with the address so 
that it is the third line instead of the fourth line* 
The first step is to set the entry pointer to the right 
place* In trying to determine where to set the entry 
pointer r the key is always to determine which two char- 
acters you want an insertion to go between* Since we 
want the line with the address to become the third liner 
we want it to go between the second line and what is 
currently the third line* In other words r we want to 
move what is now the fourth line to the location between 
the first character of what is now the third line and 
the preceding character* This is achieved by J 



f\ ••» Mi 



3....% 



or alternately 



Now to actually execute the move we use the command* 
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M4..% 

or 
M4! 

Th*» f i . I e will now look, like* 

NAME! vIOHN DOE 

occupation: deer 
address?. the woods 

SEX? MALE 

Notice* that the whole Job could have been done with 
a s i n g I e o o m m a n d ? s a y * 

"3!vM4! 

H o weverf w h i 1 e y o u m a y f i n d ^r-<e o u r s e I f u s i n g s u e h o o iti in a n d s 
often when you xr® accustomed to DISK ATE? it's always 
w :i. s e a t f i r s t t o m a k e s u r e t h e © n t r y p o i n t e r i s i n t h e 
r i g h t p 1 a e e b e f o r e iti a k. i n g a n y oh a n g e * A m o r e c a u t i o u s 
s e o u e n c e w o u I d b e ~ 3 ! ? ' t o s e e t h e p o s i t i o n o f t h e e n t r y 
p o i n t e r ? f o 1 lowed by M4!» 

The move command is one of the most powerful in the 
D I S K A T E t e x t e d i t o r ? a n d t h e r e :i. s n o I i m i t t o t h e s i z e A E T E R M 
of the block, than can be moved* After a move command COMMAND 
h a s b e e n e x e c u t e d t h e t a r g e t c h a r a c t e r w :i. 1 1 b e t h e s a m e 
character within the text as it was beforev but the TARGET 

a d d r e s s o f t h a t c h a r a c t e r w i 1 1 b e c h a n g e d b y t h e i n s e r C H A R I S 

t i o n ♦ I n t h e e x a m p I e a b o v e y a f t e r '* 3 ! t h e t a r g e t c h a r - 1 S T H A R 
acter is the S i\~t SEX? and after the move command the AETER 
tar set character remains the S in SEXy even though this CHARS 
is now in a different place* To be specific? after b\"\ M INSERTED 
command the target character is the character after the 
group of characters inserted by the move* 

Let's look, at another example of using the Move 

command •- one that hopefully you won't have to use* 

Over and over we've mentioned that to resume text entry 

after having made some changes? the entry pointer must 

s o m e h o w b e r e s t o r e d ♦ S e v e r a 1 m e t h o d s f o r d o i n g t h i s 

have been shown* But suppose the worst happens? and you 

forge t t o d o t h i s * H o w d o y o u r e p a i r t h e t e x t ? T y p i - 

o a 1 1 y i t w i 1 1 b e w i t h a M o v e c o m m a n d y a n d w h a t f o 1 1 o w s 

i s a " r e a I i s t i c " e x a m p I e * T o m a k. e i t s e e m n a t u r a I a n d E X A M P I... E 

e a s y t o u n d e r s t a n d y wo?' 1 1 a s s u m e i n t h e e x a m p 1 e t h a t F 

we're c 1 r e a t i n g a n d e d i t i n g a B A S I C p r^ o g r a m - - e v e n U S IN G M 

though you may not be using DISKATE to edit BASIC* COMMAND 

We're Just at the stage of writing the body of comments TO 

t h a t w i 1 1 g o a t t h e b e g i n n i n g o f t h e p r o g r a in ♦ B e o a u s e R E C U E R 

t h i s e x a m p 1 e w i 1 1 d e a I w i t h s e v e r a I D I S K A T E c o m m a n d s i n F R M 

succession? in this case we will SHOW THE PROMPT POINTER 

C H A R A C T E R s o t h a t t h e e x a m p I e I :i. s t i n <-J s w i 1 1 look ,. i u s t I N T H E 
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1 :i. k e t h e w w o u .1. d o n w o u r t e r m :i. n a .1. ♦ H e r e :i. s how t h e W R N (3 
c i..i r r e n t f i 1 e 1 o o k s * P • A C E 

100* REM BASIC PROGRAM FOR BENCHMARKING CHARACTER HANDLING 

200 REM 

300 REM PROGRAM WILL ENTER INTO A STRING VARIABLE A 

400 REM SEQUENCE OF RANDOM LENGTH INITIAL SEGMENTS OF 

450 REM THE ALPHABET TERMINATED BY A CARRIAGE RETURN* 

460 REM 

500 REM ON A SECOND PASS THE SEGMENTS WILL BE 

600 REM SEPARATED AND PRINTED OUT* 



We notice that there is bh extra space following 
the word PASS in statement 500? and we want to get rid 
of it* 

>"T'30o::i%!i: :u * 

500 REM ON A SECOND PASS" THE SEGMENTS WILL BE 

>K"r "** 

100 REM BASIC PROGRAM FOR BENCHMARKING CHARACTER HANDLING 

200 REM 

300 REM PROGRAM WILL ENTER INTO A STRING VARIABLE A 

400 REM SEQUENCE OF RANDOM LENGTH INITIAL SEGMENTS OF 

450 REM THE ALPHABET TERMINATED BY A CARRIAGE RETURN* 

460 REM 

500 REM ON A SECOND PASS THE SEGMENTS WILL BE 

600 REM SEPARATED AND PRINTED OUT* 



Everything looks good* (Remember that in a command 
like K"*j> '* serves as an interval consisting of onlu one 
c h a r a e t em t h e t a r g e t c h a r a c t e r ♦ ) F o r $ e 1 1 i n g t o r e s e t 
t h e e n t ry p o i nter t o t h e e n d o f t h e f i 1 e y we g o b 1 i t h e 1 « 
a 1 o n g e n t e r i n g a d d i t i o n a I c o in m e n t s * 

>EC700 REM 

BOO REM PROGRAM WRITTEN IN VIRTUAL BASIC VERSION 1*0 

900 REM 

1 

100* REM BASIC PROGRAM FOR BENCHMARKING CHARACTER HANDLING 
200 REM 

300 REM PROGRAM WILL ENTER INTO A STRING VARIABLE A 
400 REM SEQUENCE OF RANDOM LENGTH INITIAL SEGMENTS OF 
450 REM THE ALPHABET TERMINATED BY A CARRIAGE RETURN* 
460 REM 

500 REM ON A SECOND PASS700 REM 

800 REM PROGRAM WRITTEN IN VIRTUAL BASIC VERSION 1*0 
900 REM 
THE SEGMENTS WILL BE 
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600 REM SEPARATED AND PRINTED OUT* 



Help! ! This is not the wau the text was supposed 
t o 1 o o k ! Now t h e e u e s t :i. o n i s h o w t o p u t i t b a o k t o g e t h e r 
I n t h i s o a s e we'r e s o in e w h a t 1 u c k w ta e c a u s e t h e s t a t e in e n t 
numbers provide srt easy way to fissure out where things 
should s*o* If this were an assembler program thin sis 
mi^ht be tou si her* After star ins? at this gar bashed up text 
for a minute we can see that the last thing we entered* 
s t a t e m e n t s 700? 8 y a n d 9 y a r e o u t o f p 1 a o e ♦ T h e y 
s h o u I d h a v e g o n e a t t h e e n d o f t h e f i 1 e y b u t i n s t e a d 
have wound up in the middle of statement 500* Here is 
o n e w a y o f corr e c t i n g t h e d a m a g e ♦ W e ' 1 1 u s e t h e e n t r y 
pointer to be able to see Just where things sve by means 
of the ' command* Clearly the problem starts on what is 
now line 500* 

>"T50o::i%! i::7oo::iy ' 

500 REM ON A SECOND PASS'VOO REM 

>'M;:90o:i%i>y ' 

900 REM'" 

>Y«' n 

.• : " A + ♦ Y 

700 REM 

800 REM PROGRAM WRITTEN IN VIRTUAL BASIC VERSION 1*0 

900 REM 

.••• *••. r .••' i .•■• T .1. 

>MX**Yy"** 

100 REM BASIC PROGRAM E0R BENCHMARKING CHARACTER HANDLING 

200 REM 

300 REM PROGRAM WILL ENTER INTO A STRING VARIABLE A 

400 REM SEQUENCE OF RANDOM LENGTH INITIAL SEGMENTS OF 

450 REM THE ALPHABET TERMINATED BY A CARRIAGE RETURN* 

460 REM 

500 REM ON A SECOND PASS THE SEGMENTS WILL BE 

600 REM SEPARATED AND PRINTED OUT* 

700 REM 

BOO REM PROGRAM WRITTEN IN VIRTUAL BASIC VERSION 1*0 

900 REM 



S u c c e s s ! L e t ' s g o o v e r t h i s o a r e f u 1 1 y * F i r s t a 
word about the general method* The problem is that we 
have a piece of text in the wrong placer snd to correct 
that it has to be moved with the Move command* To 
specify the Move command requires we determine three 
things* the lower address of the interval to be moved y 
the upper address of the interval to be moved y and the 
target location to which we want the interval moved* 
The method to be used herey which is a fairly cautious 
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use of DISKATEv is to determine each of these 
separately* First the lower address of the interval to 
he moved* We decided that the thing which is out of 
place is statements 700 through 900* and statement 700 
now begins in the middle of line 500* The first thing 
w e d o * t h e n * i s set t he e n t r y p o i n t e r to the he g i n n i n g 
of where statement 700 now isy and use the ' command to 
make sure we've got it* The value of the pointer is 
then saved in Xy which will be the lower address in the 
interval to be moved* The use of the pointer here is 
not absolutely necessary y but setting the pointer and 
then viewing its location with the ' command is so 
c o n v e n i e n t a s a w a v.* o f s e e i n g w h a t w e ' r e d o i n g t h a t i t ' s 
worth the extra bother* Remember that the " command 
sets the entry pointer to the LOWER address of the 
interval which is its argument* 

The next step is to set the upper address of the 
i n t e r v a 1 t o b e m o v e d y w h i c h we' 1 1 d o b « s e 1 1 i n g t h e 
pointer y verifying that it's in the right place? and 
then saving it in the variable Y* Right here is another 
important possible source of error* The '" command y as 
well as a command of the form* variable- arguments will 
take the LOWER address of the argument* What we want 
h^r& is the UPPER address of the interval to be moved* 
T h a t ' s w h w we had t o g i v e t h e c o m m a n d " % \" 9 :i % ! > i n s t e a d 
of simply ' n i:900:i%* T900::i%!> sets the entry pointer to 
the upper address of the interval l"900"l%* 

Finally we set the entry pointer to the place where 
we want the interval moved* which is the €»nd of the 
file* The command for doing this we've already seen* 
As a final precaution y the command "X**Y will show us 
the interval we av^ about to move* so that we can have 
one last check that it is specified correctly* At last 
we are ready for the Move command itself* which is 
simply MX**Y since we have set everything else up* 

This may seem like a lot of trouble to have gone to 
In fact* the whole thing could have been accomplished by 
t h e s i n g 1 e e o m m a n d ♦ 

"<F> ! >+ 1 y M i: 700 1 * * C 900 !1 X 

Why on earth should you go through all the work that we 
did when such a simple command will work?? The answer 
i s t h a t t h e s i m p 1 e c o m m a n d w i 1 1 w o r k b e c a u s e we ha p p e n 
to know it is correct* When you are working on editing 
in actual usage* you may be Just as likely to make a 
mistake in a command such as the one Just above as you 
were to make the mistake which this command is supposed 
to correct* The simple command above gives you no 
feedback at all to see if the operands are specified 
correctly before tha actual move takes place* There is 
nothing more frustrating in text editing than to make a 
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mistake in entering a command which is simply aimed at 
c o r r e c t i n g a s t i 1 1 p r e v i o u s m :i. stake* f c o u r s e y t h e 
more experience you get with D I SKATE* the more you will 
be able to use such simplified commands with no trouble* 

By now we have* presented all of the most basic 
DISK ATE text editing commands** The editing commands 
t h 3 1 are p r e s e n t e d b e 1 o w are a n a m o r e a d v a n c e d 1 e v e 1 y 
and allow you to perform editing tasks repetitively and 

create your own "edit macros" programs that accom- 

p 1 :i s h c o m p 1 e x e d :i. t :i. 1 "1 g f 1..1 n c t i o n s ♦ Y o u s h a u 1 d p r o b a b 1 y 
a 1 1 e m p t t o f a m i 1 :i. a r i z 0? y o u r s e 1 f w i t h t h e u s e o f t h e 
commands discussed so far before going on to try the 
tec-hnieues that are going to be presented now* 

Above we saw that you v^&n replace a portion of text 
w i t h some t h i n g else by g i v i n g a K c o m m a n d f o 1 1 o w e d b y a n 
E command* This is fine if you want to change a single 
instance? but what if you want to make the change in 
several places? It freouently happens in text editing 
that you have to change EVERY occurrence of a part of 
t h e t e x t t o s o m e t h i n g e 1 s e ♦ F o r i n s t a n c e » y o u m i g h t 
d i s c o v e r t h a t y o u h ad s y s t e m a t i c a 1 1 y m 1 s s p e 1 1 e d a w o r d 
every time you used it? or in editing a program you 
might be forced to charge the name of a variable? which 
would mean changing it everywhere it occurred* Dl SKATE 
provides very powerful commands for performing this kind 
o f t a s k ♦ Of co u r s e ? t h i s p o w e r i f u s e d evv on e o u s 1 y c a n 
leave you with a monster Job of cleaning up? so great 
care must be used to make sure these powerful commands 
do not themselves contain errors* 

Let's start with a simple example* Suppose that we 
have a f i 1 e w h i e h i s a 1 i s t of en t r i e s e a c h o n e h a v i n g 
the same format as our dog-eared JOAN DOE file* After 
numerous complaints from the clientele we are pursuaded 
that it isn't good form at all to keep maintaining a 
1 i n e i n e a c h e n t r y f o r t h e s e x o f t h e c r e a t ure 
d e s c r :i. b e d ♦ T h :i. s :i. s t h e s e v e i"i t i e s 9 a f t e r a 1 1 * S o 9 e v e r y 
1 :i. n e i n t h e e n t ire f i 1 e c o n t a :i. n i n g t h e p at t e r n I!' S E X ♦ 1 
iti u s t go* B e f ore s h o w i n g h o w :i. t a 1 1 c a n be do n e w i t h a 
single command? let's see how we would get rid of these 
1 i n e s o n e a t a t i m e ♦ T h e f :i. r s t s u c h 1 i n e i n t h e f i 1 e 
c o 1..1 1 d b e e 1 i m i n a t e d b y t he co in m a n d ♦ 

ktsex::i% 

Now what about the next such line? Remember that a 
p a 1 1 e r n m a t c h i n g ar g u m e n t s u c h a s I" SEX* "I X w i 1 1 c a 1 1 f o r 
a search through the entire initial reference interval y 
in this case the current file? starting at the 
beginning* We have already axed what was the first 
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o e c u rrence of C S E X ♦ ! 3 % y so t he pa 1 1 e r n I" S EX* I % w :i. 1 1 N W 
m a t c h w h a t o r i, $ i n a 1 1 y was t h e S E C N D o c u r r e n o e o f 
T S E X ♦ "I % v s i n ce we d e I e t e d the o r i g i n a I first o c e u rre n e e ♦ 
This means that to kill the newt occurrence of the 
pattern we can give the identical command KTSEX*"l%y snd 
keep on giving the same command any number of times to 
k :i. 1 1 o f f t h e o f f e n d i n g 1 i n e s o n e b y o n e ♦ 8 u p p o s e f o r 
the moment that we happen to know that the file has 47 
e n t v i e s v s o t h a t t h e c o m m a n d w i 1 1 h a v e t o b e g :i. v e n 4 7 
times* It's obviously a ridiculous nuisance to have to 
a c t u a .1. 1 y t y p e i n t h e c o m m a n d t h i s m a n y t :i m e s * F o r t u n - 
a t e I y t h e y* e i s a D 1 8 K A T E c o in m a n d w h i c h w i 1 1 c a u s e o t h e r 
o o m iyi a n d s t o b e R E l :; ' E A T E D a g i v e n n « ,i m b e r o f t i m e s * T h :i. s 
is the R command* In a multi-command command line* the 
sequence* 

R n » o t h e r c o m m a n d s 

w i 1 1 e a i..i s e o t h e r c o m m a n d s t o b e r e p e a t e d n t i m e s * W e a re 
n o w a b 1 e t o p u r g e o u r n o t o r :i. o u s f i 1 e o f i t s b a s e r 
i n s t i n c t s b y t h e s i n g 1 e c o m m Bn d ? 



COMMAND 



Rn 



CAUSES 
REST OF 
COMMAND 
LINE 
TO BE 
REPEATED 
n TIMES 



R47vKi::sex*::i% 

A word of warning* In giving such commands as this 
you have to be extremely careful that a pattern in the 
part of the command to be repeated does not match more 
than you intend* Suppose for instance that instead of 
using the pattern C SEX*. 71% we had used rSEX.1%* This 
p a 1 1 e r n w o u 1 d a I s o m a t c h a I i n e c o n t a i n i n *•* t h e n a m e 
THOMAS W E 8 S hi X y f o r i n s t a n c e 9 w h i c h i s n o t o n e o f t h e 
I i n e s we w a n t t o d e 1 e t e ♦ "Do u nd a r y c h a r a c t ers'n s u c h a s 
spaces? punctuation and carriage returns y are often very 
important in specifying patterns that match the right 
thing* 

An obvious question here is what to do when you 
don't know how many times the command will have to be 
repeated* Actual ly? you can program D I SKATE to count 
t h e n i j m b e r of t i m e s a p a 1 1 e r n o e c u rs» and we' 1 1 s e e 
below how to do that* But we don't real 1m need to go to 
all that worM. ♦ The simplest approach in giving a repeat 
command which you want to apply to every occurrence of a 
pattern is to give a repetition number which you v^&n be 
sure is greater than the number of times the pattern 
w i 1 1 o c c i.j r * I f w e k n o w f o r i n s t a n c e t h a t t h e r e a r e n o t 
more than a few h u n d r e d e n t r i e s i n t h e f i 1 e b u t d o n ' t 
know exactly how many? we could use the command* 

R9999fKCSEXn% 



A s s i.j m i n g we're c o r r e c t t h a t t h e r e a r e n o t n e a r 1 y t h i s 
m a n y o c c u r r e n c e s of t h e p a 1 1 e r n C S E X J "I % i n t h e f i I e 9 t h e 
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c o in m 3 n d w :i. 1 1 b e rep e a ted u n t i I 1 a 1 1 o f t h e o c e u r r e n c e s 
of the pattern have been deleted* Then what? The 
p a 1 t e r n C S E X * 1 % w :i. 1 1 f a :j. 1 t o m a t e h a n w t h :i. n g y so a n e r r o r 
m e s s a g e w i 1 1 o cc u r ♦ 

T h o u g h t h i s m e t h o d w :i. 1 1 wor k p e r f e e 1 1 w w e 1 "I. t t h e 
obvious problem- is that we have to assume that the error 
message is divert because Dl SKATE ran out of occurrences 
of the pattern to match y rather than because of some 
e r r o r t h a t s h o u 1 d r e a 1 1 w c o n c e r n u s * 1 1 ' s b e 1 1 e r n o t t o 
have to relw on a\i error to terminate a process* so 
we' 1 1 s e e i n a m :i. n u t e h o w t o a v o i d t h i s * n e n o t e * 
R e p e (•.. i t :i o i "i n u m b e r s a r e t r e a t e d a s P 8 1 T I V E * T h a t in e a n s 
that -I. is the same thins* as 65535* So y if wou want to 
u s e t h e " 1 a r g e n i..i iyi b e r " m e t h o d f o r t h e R o o m m a n d v t h e 
simplest number to use for the number of repetitions is 
•••• 1 y s i n c e t h i s :i. s t h e 1 a r g e s t r e p e t i t i o n n u m b e r D I S K A T E 
w i 1 1 a 1 1 o w * ( 6 5 5 3 5 i s o b v i o u s 1 w 1 arti e e n o u g h f o r a n w - 
t h i n g y o u w o u 1 d w a n t t o -d o » s i n c e f i 1. e s m u s t f i t i n t h e 
m e m o r y a n d 6 5 K i s t h e 1 i in :i. t t o t h e s i z e o f t h e m e m o r w * ) 

The problem we dust encountered c^an be phrased as 
f o 1 1 o w s * H o w o a n w e b r e a k a r e p e t i t i o n 1 o o p w h e n w e ' v e 
run out of matches without terminating the Loop with an 
e r r o v ? T h e r e i s a D I S K A T E c o m m a n d e s p e c i a 1 1 w f o r t h :i. s 
p u r p o s e * T h e c o in m a n d Q F ? w h i o h s t a n d s f o r Q u :i. t o n 
F a i 1 i..i rev w i 1 1 t e r m i n a t e a r e p e a t 1 o o p w i t h o u t a n e v r o r 
if in evaluating the argument of the QF command a match 
f a i 1 s ♦ So? we c a n d o w h a t w e d i d a b o v e w i t h o u t h a v :i. n <$ 
to end in an error bw the command* 

r- • :i. v qf i: sex t ::i % v k c sex j ::i % 

The R~i will cause the rest of the command to be repeat- 
e d 6 5 5 3 5 t i m e s y a n d t h e Q F : ' I" S E X * "\ X o o in in a n d w i 1 1 t e r in i n a t e 
the loop without an error if there is nothing which 
m a t c h e s I." S E X * !1 % ♦ 1 n f a c t w e c a n m a l<. e t h e c o m m a n d m u c h 
simpler* Recall that if a command takes an argument but 
none is given* DI SKATE uses the last argument computed* 
In the command line above the argument of the QF command 
is identical to the argument of the K command * so the 
command can be simplified to* 



R-i yQFi::sExi::i%yK 

This is an examp 
c o m m a n d w h i c h w i 1 1 d e 
i n a f i 1 e ♦ I n g e n e r a 
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R-~ .1. y QFpatte rn v K 



t o d e I e t e f r o m t h e c u r . r eh t f i I e e v e r s.i o c c u r r e n c e o f 
pattern* Suppose we want to REPLACE EVERY OCCURRENCE of 
one pattern bw a piece of text* This can be done exact- 



REPLACE 
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ly the same wayy remembering that a K command foil. lowed 
by an E command replaces the argument of the K command 
with the entered text* Thus the command* 

R - 1 y Q F p a 1 1 e r n y K y E C t e x t "I 

will replace? every occurrence of pattern with text* (In 
word processing systems this operation is often called 
■ g 1 o b a 1 s e a r c h a n d vbp 1 ace" ♦ ) 

I n d e t e r m i n i n g w h © t-h e r a m a t c h i n g fa i 1 u r e h a s t a k e n 
place for an .argument of a QF command? even if there are 
no matching symbols in the argument? a "matching 

failure" - perhaps argument failure is a better term •••••••• 

will still occur if the lower address of an interval 
turns out to be larger than the upper address* This can 
a c u t a 1 1 y b e u s e d for c o m p a r i s o n o p e r a t i o n s ♦ W e ' 1 1 s e e 
a n e x ample of this i n I ♦ 2 * 

T'n effect a command line using the R command 
constitutes a miniature program* Becuase it so often 
h a p p e n s t h a t y o u w i 1 1 w a n t t o e x e o u t e a p r o g r a m m e d 
s e R u e n c e of D I S K A T E c o m m a n d s y D I S K A T E p r o v i d e s t h e 
facility to execute a sequence of commands that ar^ 
s tor & d i n t h e m e m o r y a s a 1 1 o r p a r t o f a f i 1 e ♦ u r n e x t 
major goal is to discuss this facility* but before we do 
it's time to present the commands that enable you to use 
m u 1 1 i p I e f i 1 e s ♦ f t e n y o 1. .1 m a y o n 1 y w o r k w i t h a s i n «S 1 e 
s o u r c e f i 1 e a t a t i m e y b u t w h e n e n t e r i n g a s e e u e n c e of 
commands which is to be executed by DISK ATE? more than 
likely they will want to go into a file separate from 
the material they operate on* 

As we me n t i o n e d a t t h e b e g i n n i n g of t h e m a n u a I y a 
file is a seeuence of bytes bounded by O's* The current 
file is included in the source area? which may contain 
several files* Suppose you want to begin editing a new 
f i ley w h i 1 e r e t a i n i n g the c u r r e n t f i 1 e i n t h e s o u r c e 
area for use later* The command to be used is the N 
c o m m a n d y < N for New f i 1 e y ) w h i c h t a k e s n o a r g u m e n t ♦ 
T h i s c o m m a n d c r e a t e s a n e w e m p t y c u r r e n t f i 1 e a t t hi e e n d 
of the source arean and expands the source area to 
include it* Any editing you do on this new current file 
w i 1 1 1 e a v e t h e o I d f i I e i n t a e t ♦ ( T h a t ' s a s s u m i n g y o f 
course y that in editing the new file you don't make an 
error in an argument causing it to specify an address 
outside of the current file*) If you want to edit 
s e v 0? r a 1 f i 1 e s y t he N o o m m a n d c a n b e g i v e n a n y n '..1 m b e r o f 
timesy as long as you don't run out of memory* 

By using the N command you can create several files 
in the memory* Now the euestion isy suppose you want to 
go back and look at one of the previous files? To do 
this you use the F command y (F for File*) The F command 
is different from all of the commands we have described 
so far in that THE INITIAL REFERENCE INTERVAL FOR THE F 
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COMMAND IS THE WHOLE SOURCE AREA* The actual operation THE FILE 

f t h e F o o mm a n d :i. s s a m e w h a t d © t a :i. 1 e d 9 b u t t h e b a s :i. o C N T A I N •••• 
idea is that it TAKES THE LOWER ADDRESS of the argument I NO THE 
given and MAKES THE FILE CONTAINING THAT ADDRESS LOWER 

C I J R R E NT* R e m e m b e r t h a t a f i 1 e :i. n t h e m e m o r w i s b o u n d e d A D D R E S S 

by O's* When D I SKATE is given an F command it evaluates OF ARG 
t h e a r g u m e n t a n d u s e s o n 1 w t h e 1 o w e r a d d r e s s * F i r s t i t 

'looks to see if this location contains a • if so it INITIAL 

a s s 1..1 m e s t h a t t h :i. s i s t h e b e g i n n i n g 1 o c a t i o n o f t h e f i 1 e ♦ R E F 

If not? it begins searching backward from this location INTERVAL 

looking for a 0s> and when it finds it? sets this as the IS WHOLE 

b e g :i. n n :i. n g o f t h e f i I e * H a v i n g f o u n d t h e b e g i 1 "1 n i n g o f S U R E 

the file* D I SKATE searches forward from the argument AREA 

1 o c a t i o n 1 o o k i n g f o r a n o t h e r w h i c h w i 1 1 b e t h e e n d o f 

t h e f i I. e ♦ W h e n i t h a s d e t e r m i n e d t h e f i 1 e b o u n d a r :i. e s ? T A R G E T 

the file is made current and THE TARGET CHARACTER IS SET CHAR IS 

TO DE THE WHICH ENDS THE FILE* END OF 

The F command also ADJUSTS THE SOURCE AREA* If the FILE 
f i I e b o 1. j n d a r i e s d e t e r m :i, n e d p I a c e t h e f i 1 e e n t i r e I y 

w i. t h i n t h e c u r r e n t s o u r e e a r e a * t h e s o u r c e a r e a s t a y s S 1 J R E 

u n c h a n g e d ♦ I f t h e f i 1 e b o u n d a r i e s p 1 a c e t h e f i 1 e A R E A 

entirely outside of the current source area* the source ADJUSTED 

a r e a i s r e d e f i n © d t o b e t h e f i 1 e d e t e r m i n e d b y t h e F T 

command* Nothing happens to the old source av^a in the INCLUDE 

memorw - the only thing that is changed is that the THE FILE 

internal pointers D I SKATE uses to define the limits of 
t h e s o u r c e ar^ a a r e r e s e t * I f o n e o f t h e f i I e b o u n d a r - 
i e s I i e s i n s i d e t h e e u r r e n t s o 1..1 r c e a r e a b u t t h e o t h e r 
doesn't? the source area is expanded to include the file 
determined by the F command* 

I... e t ' s s e e how t h e F c o m m a n d w o u 1 d w o r k w i t h a 
s i m p I e e x a m p 1 e ♦ L e t ' s s u p p o s e wt? ' r e u s i n g D I S K A T E t o 
edit a letter to George Morrow expressing how much we 
like his memory boards* Somewhere in the first few 
1 i n e s w i 1 1 b e a I i n e c o n t a i n i n g t h e p a 1 1 e r n I" G e o r g e 1 * 
Now suppose we use the N command to set up a new empty 
file? and in this file we put a string of D I SKATE 
o o m m a n d s u s e d t o f o r m a t t h e I e 1 1 e r ♦ W e ' 1 1 s e o? b e 1 o w 
s o m e e x a m p 1 e s o f s u c h M e d i t m a c r o s " * D e f o r e w e e x e o u t e 
t h e s e w e w a n t t o 1 o o k o v e r t h e f i 1 e w i t h t h e I e 1 1 e r o n e 
more time to make sure it is 0*K* At this point the 
source a r e a c o n s i s t s of t w o f i I e s ♦ t h e f i 1 e w i t h t h e 
1 e 1 1 © r » f o 1 1 o w e d b w the f i 1 e w i t h t h e D I S KATE c o m m a n d s ♦ 
T h e f i 1 e w i t h the c o in m a n d s i s c u r r e n t * T h e c o m m a n d ♦ 

FTOJeorge"! 

w i 1 1 m a k e t h e f i 1 e w i t h t h e 1 e 1 1 e r c u r r e n t y a 1 "1 d s e t t h e 
t a r g e t c^ h a r a c t e r t o t h e e n d o f t h e f i I e * R e m e m b e r t h a t 
the initial reference interval for the F command is the 
whole source arear so in executing the F command D I SKATE 
will begin searching for the pattern I" George "I at the 
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b e g i n n :i. n g o f the so u r c e area* w h i c h i s t h e f i 1 © w i t h t h © 
letter* 

Suppose we had written three letters y one each to 
Tom? Dicky and Harry y Br\d following that had a file with 
c o m iti a n d s ♦ If we w a n t t o see the f i 1 e w :i. t h t h e 1 e 1 1 e r t o 
Hsrr« we cbh use the command* 

FT Dear Harry 3 

(It might not bo? a good ideB to use the command 
F C H & r r w "I y s i n c e t h e 1 e 1 1 e r t o T o m m i g h t t a 1 k a b o u t 
Harry* ) 

There is also a simple way you cbh "page through" 
t h e f :i. 1 e s w i t h o u t k n o w i n g w h a t a n y o f t h e i r con t e n t s 
a r e * S i..i p p o s e y o u w a n t t h e c u r r e n t f i 1 e t o b e t h e f i r s t 
file in the source sveBr whatever that is* The command J 



•er> 



F<S> 

ARGUMENT 
will do the trick* <S> is a symbol we haven't seen DENOTING 
before* It is analogous to <F> Bnd denotes the source SOURCE 
area* It does not call for matching* Since the F com- AREA 
mand only uses the lower address of its argument y F<S> 
w i 1 1 m a k e t h e f i r s t f i 1 e i n t h e s o u r c e area e u r r e n t ♦ < N 

Now suppose we want to see the next file in the MATCHING) 
source area* As usual with D I SKATE there are many ways 
o f d o i n g t h is* We saw a b o v e t h a t t h e c o m m a n d '" < F > I > + 1. 
will set the entry pointer so that the target character 
is the at the end of the file* That means that the 
argument <F>!>+1 will specify the at the end of 
c u r r e n t f i I e ♦ B u t y i f a n o t h e r f i I e f o 1 1 o w s t h e c u vre n t 
file in the source areay this will also be the which 
f o r m s t h e I o w e r b o u n d o f t h e f i 1 e w h i c h f o I lows* So* i f 
we give the command* 

F<F>!>M. 

i. t w i 1 1 s e t the c u r r e n t f i 1 e t o b e t h e f i I e f o 1 1 o w i n g 
what hBd been the current file* (Don't be confused 
about "F" BPPBBrinf^ in both the command and the argument 
— this is Just the same as the principle behind a 
s t a t e in e n t I i k e X « X f :l. ♦ ) r y w e c o u 1 d J u s t as w e 1 1 h a v e 
g i v e n t h e c o m m a n d ♦ 

F~:l. ! 

There is Just one problem with this method* Sup- 
p o s e y o u J u s t d o n ' t remember w h i c h is the 1 a s t f i I e i n 
t h e s o u r c e Br e B9 so t h a t y o u aren't able to re c o g n i z e 
t h e 1 a s t f i I e when y o u see it* The c o m m a n d F < F > ! > + 1. 
c a 1 1 s f o v n o mate h i n g y a n d n either d o e s F - .1 ! y so t h a t i f 
t h e c u r r e ri t f i 1 e h a p p e n s to be t h e I a s t o n e i n t h e 
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source area and you execute this command anyway y it maw 

n o t r e t u r n a n e r r o r m e s s a g e y b u t i n s t e a d w i 1 1 g i v e y o u a 

file consisting of .garbage* This could give you a 

s i g n i f i c a n t s u r p rise! W h a t we w o u 1 d 1 i k e i s a m e t h o d o f 

setting the current file to be the next file in the 

source area but which would give an error message if we 

h a p p e n e d t o a 1 read y b e a t t h e 1 a s t f i 1 e * H e r e i s a C M M A N D 

c o in in a n d t h a t w i 1 1 d o t h e t r :i. c k * T M A K F 

NEXT 
"<F>!>+1. yF"\ * !2(» FTI..FT IN 

BOURCF 
L e t ' s s e e h o w t h i s w o r k s * "* < F > ! > + 1 w e h a v e a 1 r e a d w A R F A 
s e e n a s a o o m m a n d w h i c h w i 1 1 s e t t h e p o i n t e r t o t h e e n d U ft R I!" N T 
of the file* This may not be necessary if you have done 
n o e d i t i n g o n t h e o u r r e n t f :i. 1 e y b u t we' 1 1 i n c 1 u d e i t t o 
be safe* Now let's look at the argument in the second 
command on the command line above* Beeuase it is the 
argument of an F command y the initial reference interval 
i s t h e e n t i r e s o u r e e a r e a y s o ""' ♦ ♦ s p e c i f i e s e v e r y t h i n g 
in the source ari^a following and including the at the 
e n d o f t h e c u r r e n t f i 1 e ♦ " * * ! 2 (? s p e c i f i e s t h e s e o o n d 
o ft a r a o t e r w i t h i n t h e i ft t e r v a 1 w e J u s t m e n t i o n e d ♦ 1 f 
t h e r e i s a f i 1 e f o 1 1 o w i n g t h e c u r r e n t f i 1 e y t h e n y t h e 
argument "♦♦12(3 will give the first character of that 
f i 1 e ♦ ("*♦♦! $ w o u 1 d g i, v e t h e f o r m i n g t h e 1 o w e r b o u n d 
o f t h e f i 1 e * ) H o w e v e r y i f t h e r e :i. s n o s u c h f i 1 e t h e n 
a f t e r " % < F > ! > f- 1 y "* w i 1 1 p o i n t t o t h e h i g h e s t a d d r e s s i n 
t h e s o u r c e a r e a y ir> o t h e a r g u m e n t "* ♦ ♦ ! 2 (? w i 1 1 p r o d u c e a 
m a t c h :i n g f a i 1 u r e a n d h e n (^ e a n e r r o r ♦ T h u s t h e F /% * ♦ ! 2 13 
w i 1 1 <-1 i v e a n error i f t ^^ e r e i « > n o f i 1 e f o 1 1 o w i r - i g t h e 
current fi ley or else if there is such a file will make 
it current* Of course y the command* 

"••••1 ! yF"\ * !2(» 

w o u 1 d w o r k J u s t a s w e 1 1 ♦ 

At this point a digression is in order to discuss 
one of the "side effects" of the F command* Above we 
gave a 3 rest deal of attention to the problem of having 
as close to a foolproof method as possible for setting 
t h e e n t r y p o i n t e r t o t h e e n d o f t h e f i 1 e a f t e r c o r r e c - 
tions have been made on entered text* We also saw an 
example of how unpleasant it can be to forget to do 
t h i s * We've a 1 s o m e n t i o n e d t h a t t h e F c o m m a n d w i 1 1 
p o s i t i o n t ft e e n t r y p o i n t e r t o t h e e n d o f t h e f i 1 e t h a t 
it makes current* Perhaps this is a clue to how we might 
ta e a b 1 e t o h a v e a s h o r t e r c o m m a n d w h i c h w i 1 1 s e t t h e 
e n t r y p o i h t e r t o t he e n d o f t h e c u r r e n t f i 1 e * n e 
p o s s i b i 1 i t y y w h i c h i s c e r t a i n 1 w a s h o r t c o m m a n d y is* 
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While this will work in manw cases y it is somewhat 
dangerous to rely on it habitually* The reason is that 
there is no guarantee that the target character is 
actual 1« within the current file* In all of the exam- 
ples we have seen so far* the target character did stay 
within the current file? but in those cases where you 
are using D I SKATE as a monitory which is discussed in 
t h e n e x t s e c t i o n y y o u will f r e o u e n 1 1 w exec u t e c o m m a n d s 
which place the target character outside of the source 
a r e a a 1 1 o g e t h e r ♦ 

A much safer alternative is the command* 



T h i s c a m m a n d s ays? t a k e t h e c u r r e n t f i 1 e a n d m a k e i t 
e u r r e n t * A bit ved u n d a n t » o f c o u r s e v bu t i t w i 1 1 
p o s :i. t i o n t h e e n t r y p o i n t e r re 1 i a b 1 y t o t he e n d o f t h e 
o u r r e n t file? an d i s * s h o r t e r a n d s i m p 1 e r t h a n t h e c o m •- 
m a n d " < F > ! > + 1 ♦ 1 1 ' s m o r e s t r a i g h t f o r w a r d t h a n *"* - 1 ! y b u t 
wou can choose whichever is easier to remember* 

Now we can get to the real goal of the present 
discussion* how to write sequences of D I SKATE commands 
w h i c h c a n be ex e c u ted as "edit m a c r o s " ♦ T h e f 1 e x i b i 1 
i t y w h i c h t h i s f e a t u re o f D 1 S KATE a 1 1 o w s p r o v i d e s f o r a 
v i r t u a 1 1 y u n 1 i m i t e d r a n g e of a p p 1 i c a t i o n s ♦ We' 1 1 b e g i n 
with examples which are very simple* One simple appli- 
cation for edit macros which could arise very often is 
substituting for an abbreviation the text the abbrevia- 
tion stands for* If there is a long phrase that occurs 
over and over in your text* for instance? it would be 
nice to have an abbreviation for it and then use the 
D 1 SKA T E e d i t m a c r o f a c i 1 i t y to rep 1 a c e t h e a b b r e v i a t i o n s 
with the expanded form* To use an example that occurs 
f r e « u e n 1 1 y i n t h i s it* a n u a 1 y s u p p o s e w e u s e the s y m b o 1 
I ♦ R * 1 ♦ to s t a n d for i n i t :i. a 1 r e f e r e n c e i n t e r v a 1 ♦ W i t h o u t 
u s i n g any e d i t m a c rosy we c o 1. j 1 d i n s t r u c t D I S KATE to 
r e p 1 a c e e v e r « o c c u r r e n c e of the I ♦ R ♦ I ♦ b y t h e f u 1 1 t e x t 
u s i n g t h e c o m m and* 



F<F::;- 

ANOTHER 

SIMPLE 

COMMAND 

TO PUT 

ENTRY 

POINTER 

AT END 

OF 

CURRENT 

FILE 



R -• 1 y Q F C I ♦ R ♦ I ♦ 1 y K y E T i n i t i a 1 ret ere n c e i n t e r v a 1 "I 



If we found ourselves wanting to issue this command 
frequently y it's a long one to keep having to type in 
every time* Let's see how to set it up as a macro y so 
that it can be executed with a very short command line* 
First we have to enter it into the memory* We can do 
this with the commands* 

N y E C R- 1 y QF C I « R • I « .1 y K y E T i n i t i a 1 r ef e rence i nte r va 1 .1 1 
F<S> 

For the moment we'll assume that there will be only one 



D 
COMMAND 

EXECUTES 

STRING 

OF 

DISK ATE 

COMMANDS 

STARTING 

WITH 
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file with the text* and- then a second file with the LOWER 

it« a e r o * T h e F < S > c o m m a n d will res t o r e t h e t e x t f i 1 e a s A D D R E 8 8 

the current file* Now the Question isy how do we ewe" OF ARG 

cute the macro? Macros are executed usinst the DI SKATE 

command By which stands for Do* Like the F command'* THE INITIAL 

INITIAL REFERENCE INTERVAL FOR THE D COMMAND IS THE REF 

ENTIRE SOURCE AREA? and the D command only uses the INTER' MAI. 

1 o w o? r a d d r e s s o f i t s a r *,* u in e n t * T o e x e c u t e t h e m a c r o a 1 1 1 8 

we \ibvb to do is fissure out an argument which will spe™ SOURCE 

oify where the macro is in the source area and «*ive a D AREA 

command with this argument* 

T h e c u r r e n t f i 1 e i s t h e t e x t f i I o* o n w h i o h t h e 
m a c r o w i 1 1 o p e r a t e ♦ < F > i s a n a r «s u m e n t w h i e h w i 1 1 
s p e c i f y t h i s f i I e y a n d t h e u p p e r a d d r e s s i n < F > i s t h e 
1 a s t c h a r a c t e r o f t h e f i 1 e ♦ < F > ! > + 1 w o u 1 d s p e c i f w t h e 
f o r m i n «* t h e u p p e r b o u n d o f t h e f i 1 e y s o s i n c e t h e m a c r o 
:i. m m e d i a t e I y f o 1 1 o w s t h e t e x t f i I e y < F > ! > + 2 w i 1 1 s p e o :i. f y 
t h e f i r s t c h a r a c t e r o f t h e m a c r o ♦ Soy e v e r y t i m e w e 
want to execute the macro we can type the command* 

D<F> ! >+2 



There is something very unsatisfying about this* 
The command D<F> ! >+ 2 is one that is difficult to remem- 
ber and it would be easy to make a mistake in twpinsi it* 
1 1 w o u I d b e b e 1 1 e r if w e c o u I d $ i v e t h e m a c r o a n a m e a n d 
t h e n e x e c u t e i t b y c a 1 1 i n <S i t ta y n a m e * D I S K A T E h a s J'u s t 
such a provision* To name a macro you use the * com- 
mand* The # command does nothing and is ignored* This 
m e a n s t h a t t h e c h a r a c t e r s f o 1 1 o w i n $ t h e * i n a * c o m m a n d 
can be used as a label* Let's see how this would work* 
I... e t y s s a y w e w a n t t o <S i v e o u r m a c r o t h e n a m e I R I ♦ T h e 
m a c r o o r i <?J i n a 1 1 w 1 o o k e d 1 i k e * 

R • ••• :l. y Q F I" I * R * I * "I y K y E I" i n i t i a 1 r e f e t % e n c e i n t e r v a 1 !1 

To add the name to the macro it should look like* 



COMMAND 

DOES 

NOTHING y 
IS 
IGNORED 



CAN BE 
USED AS 
LABEL 
TO NAME 
MACROS 



*IRI 
R-l yQF 



I" I * R * I ♦ "I y K y E I" i n i t i a 1 r e f e r e n o e i n t e r v a 1 "I 



When the macro is executed the command >KIRI will simply 
be i s^nored* Now the Question isy how do we execute the 
macro by name? Remember that the initial v&f&vGnc<--> 
interval for the D command is the whole source area* 
The command * 

di::*:i:ri:i 

w i 1 1 t a k e a s i t s a r $ u m e n t t h e ta e s* i n n i n si a d d r e s s o f t h e 
f i r s t o c c i..i r r e n c e w i t h i n t h e w h o 1 e s o u r c e a r e a o f t h e 
c h a r a c t e r s * I R I ♦ A s s u m i n <$ t h e t e x t f i I e d o e s n o t 



COMMAND 
DDKname::! 

EXECUTES 
MACRO 
WHICH 
BEGINS 
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contain such a patterns' since the initial reference WITH 

interval, is the whole source area this argument will #name 

evaluate as exactly the beginning of our macro* Of 

courses* in giving a macro a name in this way hou has/e to 

be careful that the pattern fcmaename — where maoname is 

the name of the macro — - does not occur anywhere in the 

source area ahead of the beginning of the macro* Note 

that using this method of naming a macro using the # 

c o m m a n d and e x e c u t i n g i t b y D C * m a c n a m el* wo u can have a s 

in a n y macros a s y o u w a n 1 ? a n d t h e y c a n a 1 1 b e i n a s i n g 1 e 

f i 1 e a f t e r y o u r t e x t f i 1 e < s > o r t h e y c a n b e i h s e v e r a 1 

s e p a r a t e f i 1 e s ♦ 1 1 d o e s n ' t m a 1 1 e r w here t h e y are w i t h i n 

the source area? as long as the name is properly uniraue* 

The commands within a macro end in a carriage 
return ? Just as if they were typed in a command line* 
a n d o f c o u r s e there c a n b e sever a 1 o n a 1 i n e s e p a r a t e d 
by commas* When a macro is being executed? when the end 
o f t he f i 1 e i s reached t h i s i s a ». .1 1 o m a t i c a 1 1 y t r e a t e d a s 
a return* If the macro was invoked from the terminal taw 
a co m m a n d I i ne» c o n t r o I w i 1 1 be r e t u r n e d t o t h e t e r m i n - 
a I ♦ However? a macro c a n c o n t a i n a D c o m m a n d » s o t h a t 
macros can call other macros* In this case when the 
macro returns? control is passed to the next command in 
the calling macro* Thus the D command works like a 
GOSUB in BASIC* We saw above that the command OF can be 
used to break out of a repeat loop* It can also be used 
i n a m a c r o to re t u r n the to caller* F w i 1 1 o u i t 
whatever is the innermost process in which it occurs? 

a repeat loop or a macro? if its argu- 

m a t c h i n g f a i I u re* 

special argument that can be used in 

macros* As a macro is executed? a ? 
special "command interpretation pointer" is maintained 
internally by B I SKATE* If the macro aborts in an error? AS ARG 
the value of this pointer is saved in a special loca- SYMBOL 
tion* The contents of this location are denoted by the 
s y m b o 1 ? ? w h i c h does n o t o a 1 1 f o r m a t c h i n g ♦ I n o t h e r G X U E S 
words? ? is an argument which gives the address of the CHAR OF 
character of a macro that caused an error* You can use MACRO 
this to help debug a macro which produces errors* For THAT 
instance? if we had a macro in the source area which CAUSED 
began with the com m a n d # I R I ? a n d t h i s macro was pro d u •••• A N 
cing errors? we could find the point where the error ERROR 
occurred by the command* 



whet he r t h i s i s 

in e n t p rod u c e s a 

There is a 

c o n n e c t i o n w i t h 



:S>!C*IRI1»*? 



This would print the macro on the terminal up to the 
point that caused the error* 

When the R command was introduced we said that it 
would cause the rest of the command to be repeated* 
This is correct if the command is entered from the ter* 



COMMAND 
IN MACRO 
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minaly taut if an R command occurs as part of a macro it 
.will cause THE ENTIRE REST OF THE MACRO to be repeated 
u n t i 1 e i t ta e r a n e n d o f f i 1 e or a « u i t c o m m a n d i s 
encountered* 

Ana last ous to the QF command is the QS command y 
which stands for Quit on Success* If its argument does 
n o t p y* o d i.j c e a m a t c h i n. si f a i 1 u r e i t w i 1 1 « u i t t h e i n n e r •••• 
most process be it a repeat loop or a macro* The QS 
command can be used in repeat loops in commands entered 
f r o m t h e t e r m i n a 1 v J u s t 1 i k e t h e Q F c o m it* a n d * I f t h e Q S 
e o m m a n d i s si i v e n w i t h n o a r <3 u m e n 1 y t h e a r si u m e n t u s e d 
u.i i 1 1 h e t h e p r e v i. o u s i n t e r v a I c o m p u t e d y a s w :i. t h a n w 
other D I SKATE command* This argument can be presumed 
n o t t o h a v e & i v e n a in a t c h i n si f a i I u r e y s o t h a t; Q S W I T H N 
ARGUMENT CAN BE USED AS A RETURN COMMAND* This is 
e s p e o i a 1 I y u s e f u 1 :i. f w o u w a n t t o h a v e s e v e r a 1 m a c y % o s i n 
a single file* 

Let's put some of these pieces together and look at 
a macro which performs a function which occurs freeuent •••• 
Iw in text editing* formatting parssirsphs* After mak- 
i i"i si e d i t i n si c h a n si e s i n p r o s e t e x t i t w i I 1 o f t e n h a p p e n 
t h a t t h e m a r si i n s o f t h e I i n e s w i 1 I h a v e t o b e y* e a d J u s t 
e d * T h e m a c r o we w i I 1 I o o k a t w i I I h a v e t h r e e 
parameters y which are siiven taw sett in si the values for 
t h e v a r :i. a b I e s X y Y y a n d Z ♦ Z w i 1 1 <•* i v e t h e n u m b e r o f 
c h a r a c t e r s t h a t we w a n t a s t h e m a x i m u m 1 i n e 1 e n si 1 h y a n d 
X * * Y w i 1 I s e r v e a s a n i n t e r v a I f o r m i n si t h e b o u n d a r i e s o f 
the paragraph* Once Xy Yy and "I ar& set we want the 
c o m m a n d D I" * P A R A G R A P H 1 t o a d J u s t t h e r i ?S h t • h a n d m a r «^ :i. i"« s * 

T h e m a f : % y 4 o w i 1 1 w o r k i n t w o s t a si e s ♦ F :i. r «> t w e w i 1 1 
d e I e t e a 1 .1 t h e c a r r :i. a «•{ e r e t u r n s i n t h e p a r a s? r a p f^ y 
r e p I a c i n si t ft e m w i t ft ta 1 a n k s * T h i s w i 1 1 i n o? f f e c t t u r n 
the paraj-fraph into one enormous line* The second stasie 
w i 1 1 c ft o p i t i. j p i n t o I i n e s o f t h e p y % o p e y v I e n «( t h ♦ E a c h 
o f t h e t w o s t a si e s w i 1 1 have i t s o w n M s u ta m a c r o " y w h i c h 
PARAGRAPH will call* The macro will contain a new 
command y the 05 command which stands for Goto* The G 
command causes execution of a Dl SKATE macro to be 
transferred to the lower address of the argument y and 
w o r k s ...i u s t I i k e a G T i n B A S I C * I... :i. k e t h e T.\ c o m m a n d y 
the initial reference interval for the 05 command is the 
w h o I e s o i..i r e e a r e a * A n d n o w f o r t ta e . m aero* 

*FUSE 

QFX * * Y ! y K y E C :!l y G C *FUSE !1 

*CHOP 

QFX * * Y ! " * * Z(» y K ! • • 1. C *:i y E... y G C *CH0P :i 

^paragraph 
dt:>kfuse::i 

:oi::>kchop::i 
qs 



REPEATS 
TO END 
OF FILE 
OR QSy 
QF . 

CAUSING 
QUIT 
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COMMAND 
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A few notes* The final QS can be done away with if 
this macro ends the file* If as shown the entire macro 
i s g o i n si t o go i n o n e f :i. 1 e y t h e 1 i n e s b e g i n n :i. n g w i t h 
:« PARAGRAPH must NOT begin the file* The reason is that 
if they do* the pattern r#FUSE3 will match not the name 
of the submaeroy as we want it toy but rather the 
characters *FUSE within the Di:*FUSE::i * This could cause 
all kinds of problems* Note that in the macro CHOP? the 
K followed by the E command will leave the target 
c h a r a c t e r a s t h e c h a r a e t e r f o 1 1 o w i n g t h e c a r r i a g e re t u r n 
Just entered v setting it properlw for the next time 
around the G loop* 

There is one difficulty with this method* invoking 
a m a c r o o r u s i n g G c o m m a n d s w i t h a n a r g i. j m e n t 1 :i. k e C * n a m e "I 
will work perfectly well but could end up being extremely 
slowy since each time the command is executed DX SKATE has 
to search through the whole source area looking for the 
argument* One way around this is to use variables* For 
instance » the above example could also be done this way J 

♦FUSE 

QFX**Y!....yKyEi: 3 y G FUSE 

♦CHOP 

QFX * * Y ! ~ * * Z0 y K ! - 1 £ 1 y E .... y G CHOP 

♦PARAGRAPH 

FUSE«<S>!C*FUSE3 

D FUSE 

CH0P=<8>!C*CH0P3 

D CHOP 
QS 

Here the macro assigns the D I SKATE variables FUSE and 
CHOP to the respective arguments* This way the G com- 
in a n d s d o n o t c a 1 1 f o r a n y m a t c h i n g y a n d s o e x e c u t e m u e h 
faster* Note that whereas a D command could be given 
simply in the form D II ♦FUSE 3 y in the = statement above 
t h e f o r m < S > ! C * F U S E "I h a d t o b e g i v e n * T h e r e a s o n i s 
that the D command is one of the few commands for which 
the initial reference interval is the entire source 
a r e a y s o t h e p r e f i x < S > ! was n o t n e e d e d * F o r t h e = 
statement the initial reference interval is the current 
f i 1 e y s o t h e s o u r c e a r e a m u s t b e e x p 1 i o 1 1 1 y s e t a s t h e 
i n i t :i. a 1 r e f e r e n c e i n t e r v a 1 * 

An alternative method to using G commands would be 
t o u s e t he R c o m m a n d y b u t t h i s w o u 1 d r e « u i r e t h a t F U S E y 
CHOP and PARAGRAPH be in separate files y since the R 
command will repeat to the end of the entire file until 
a Q F o r Q S c a u s e s a e u i t * T o e n t e r t h e m a c r o s u s i n g 
this method y you could use the following seouence of 
commands* 
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N 

i : ;:i::*fuse 

R-:i. yQFX* *Yj.... y KvEi:: ::i 

ei::#chop 

R-1. 9 RFX * * Y ! "\ * Z(» * K ! -1 r 

:t ? N 

EtfcPARAGRAPH 

DIFFUSE] 

""X 

oi:#CHOp::i 



IfE 



A special command which can be? used ir\ macros or 

c o m m a n d 1 i n e s i s t h e P A U S E c o m m a n d ♦ T h e P A U S F c o m m a n d ? P All S II" 

which has no argument? will cause the process in which COMMAND 
i t o c c u r s t o s t o p :i. n a " p a n i e d e t e o t " s t a t e * Y o u e a n 

s t o p t o e x a m :i. n e t h e p r i n t o u t o n t h e t e r iri i n a 1 v a n d t h e n S T P S 

resume execution of the process by typing any character PROCESS 

o t h e r t h a n S o r F S C * T he n p a n :i. e d e t e o t " i s d i s o u s s e d IN 

more fully in Section 1*3* The message PAUSE is printed' PANIC 

o n t h e t e r m i n a 1 t o n o t i f y y o u t h a t y o u ' r e i n t h e p a u s e D E T E T 

state* This command is especially useful for such STATE 
t h i n g s a s c h a n g :i. n g d i s k e 1 1 e s * 



We conclude the discussion of using Dl SKATE as a 
text editor with two special commands which can be used DEFT cmd "I 
as a convenience to save extra typing* The command DEF 
takes as its argument a string of characters up to 24 in CAUSES 
length enclosed in brackets? as you would for art E cmd 
command* DEF stands for Default* When D! SKATE is given TO BE 
a DEI"' command « the string forming its argument is saved EXECUTED 
i n a s p e c i a 1 i n t e r n a 1 1 o c a 1 1 o n * T h e r e a f t e r 9 w h e n e v e r F R C A R 
Dl SKATE expects a command* if you simply type a carriage RET ONLY 
r e t u r n w i t h a n e m p t y c o m m a n d 1 i n 0? * t h e s t r :i. n g g i v e n a s A S 
the argument to the DEF command will he executed as a COMMAND 
default command* For instance? above we had examples of 
using the same command repetitively to see successive 
i n t e r v a 1 s o f t e x t ? s u c h a s ■ > ♦ * C ...J A N "I ! 2 # * * B y g i v i 1 1 g 
the command* 

DEFi: M >* ♦ C J0AN3 ! 20 ♦ ♦ 3 

whenever you typed a carriage return in response to the 
prompt character? Dl SKATE would execute the command 

">**i:joan::i!2(3* * 

If you don't remember what the default command is? 
t y p i n g D E F w i t h n o a r g u m e n t w i 1 1 s h o w i t t o y o u * 1 f y o u 
ha\f^ given a default command and then want to stop using 
this feature* the command* DE 



DEF 

WITHOUT 

ARC 

SHOWS 

cmd 
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defi::::i discon- 

tinues 

<DEF with an empty argument in brackets) will di scon tin- USE OF 

ue us in si the default com in and feature until another DEF emd 
command is given* 

A s i m i 1 a r c o m m a n d to DEF is R E F ♦ T h i s c o m m a n d a 1 s o R E F T a r g "\ 
takes 35 argument a character string up to 24 characters 

in length enclosed in brackets* This string is treated CAUSES 

as a DI SKATE argument and is evaluated prior to any INITIAL 

subsequent command which normally takes the current file REF 

a s t h e i n i t :i. a I r e f e r e n c e i n t e r v a I * T h i s a r g u m e n t t h e n I N T E R v" A I... 

becomes the initial reference interval for every such FOR ALL 

command* Those commands which use the whole source area COMMANDS 

f o r t h e i r i n i t :i. a I r e f e r e n c e i n t e r v a 1 ? :i. * e ♦ G ? D ? o r F ? N R M A L L Y 

BTdTf not affected? and a missing argument y <? and > also TAKING 

ar& not affected* The best way to see how this works is IT AS <F> 

by an example* Suppose you give the command* TO BE ar^i 

refi::~%:i 

REF 
Norm a 1 1 y t h e a r g u m e n t * * b y i t s o>? I f w o u 1 d m a t c h t h e N A R G 
current file* but after the REF command it would match SHOWS 
t h e I i n e w i t h t h e p o i n t e r ♦ N o t e t h a t t h e a r g u m e n t o f L A S T 
the REF command is kept as a character string and ARC 

reevaluated each time a command would normally take the GIUEN 
current file as its initial reference interval* With 
the command above? the initial reference interval 
changes every time the entry pointer is moved to a new REFT "I 
line* As with DEF? REF with no argument shows the D I SO ON- 
string that is being saved as the argument of the last TINUES 
REF command executed? and REF I" "I discontinues the use of 
t h i s f e a t u r e u n t i I t h e n e x t R* E F c o m m a n d ♦ 

REF and DEF can be used in combination to work 
«uickly through blocks of text* For instance? suppose 
you are editing a letter in which paragraphs are sepa- 
rated by two carriage returns in a row* The commands* 

REFC'%* 1 - 

can be used together to edit paragraph by psrasfrsph* 
You would begin by giving the command "XF>* This sets 
t h e p o i n t e r a t t h e b e g i n n i n sf o f t h e file* Now t h e 
symbol ♦♦ matches the CURRENT PARAGRAPH* To get to the 
next paragraph simply type carriage return in response 
to the prompt character* Of course? if you make some 
changes? resetting the entry pointer? ♦* will then match 
the portion of the current paragraph from the entry 
p o i n t e r o n w a r d s * 

U s i n g t h e R E F c o m m a n d c a 1 1 s f or s p e c i a I c arB» a s i t 
ih effect redefines the meaning of arguments whoso? 
meaning is familiar without the use of this command* 
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I*'? I.I* ins* D I SKATE as a Monitor 



A s in e n t :i. a n © d ;i. n t h © :i. n t r o d u c t ;i. o n ? t h e r © :i. s o o n s 1 •••• 
derable overlap between this section and the previous 
o n e * M o s t o f t h e e o in m a n d s w e w :i, !l. 1 d :i. s o u s s h a v e a I y* e a d y 
b e e n i n t r o d u o e d •> T n u s i n <•* D I S K A T E a s a t e x t e d i t o r ? t h e 
o o iti m a n d s y o u «S :i. v e w :i. !l. 1 u s u a I I y a p p I y t o t h e e u r y* e n t f :i. I e 
w i t h i n t h e s o u r e e a r e a ? o r s o ivi e t :i. in e s t h e w h o I e s o u r o e 
a r e a * I n u s :i. n & D T S K A T E a s a m o n i t o y* ? t h e o o in in a n d s y o u 
# i v e in a y a p p I y a n y w h e r e i n t h e o o in p u t e r ' s m e in o r y <■ S o in e 
nf these commands WILL FUNCTION DIFFERENTLY ' IF THE 
TARGET IS OUTSIDE THE SOURCE AREA* Naturally all such 
d :i f f e r e n c e s w i 1 1 h e p o i n t e d en u t * 

I n a d d i t i o n t o u s 1 n *•* A S C 1 1 e o d e s ? w h e n u s :i. n <•? 
D I S K A T E a s a m o n i t o r y o u w i 1 1 a I s o w a n t t o d e a 1 w i t h t h e 

o d e s d i r e c 1 1 y ? p r o b a b I y i ri h e x a d e o :i. iti a I o r o c t a I * W h e n 
y o u b r i n «* ». j p D I S K A T E t h e y v e w i 1 1 b e a n i n i t i a .1 1 y e s f , a b •••• 

1 :i. i-i. h e d (!' U R R III! NT DA S E ♦ T h e c u r r e n t b a s e r e p r e s e n t s t h e 
base in which numbers from D I SKATE are OUTPUT ♦ When you 
input numbers to DISK ATE? THE BASE MUST ALWAYS DE GIVEN 
EXPLICITLY* If no base is specified? D I SKATE assumes 
that the base of Bn\-.i number typed in is DECIMAL* There 
ar^ several options for specifying numbers to DISK ATE* 

F i r s t o f a 1 1 y a n » i m b e r m a y e i t h e r b e S P L I T o r n o t * A 
n u m b e r i n s p I i t f o r m i s s p e c i f i e d b *t* <$ i v i n <={ t w o n u m b e r & 
s e p a r a t e d o n I y b y a c v o I o n * T h e f i v s t n u m b e r v «t i v e s t h e 
valuo? of the hislh order byte of a 16 bit value? and the 
s e c o n d n u m b e r <$ i v e «> t h e v a 1 u e o f t h e I o w o r d o? r b y t e * 

F o r i n s t a n ce» s u p p o s e y o u a re re <•> e r v :i. n «i t h e f :i. r s t 

tt ¥->«i<}t($ tt - i *e* the first 256 byte segment in the compu- 

t e r ' «•> iti e m o r y ? f o r s p e c? i a I d r i v e r s o r i n t e r r u p t h a n d 1 i n si 
o r lv h e I i k e * T h e f :i. r s t a d d r e s s t h a t y o u tvi :i. <-i h t h a v o? a 
p r o # r a m o c c i.i p ^:i ? t h e n ? c o u 1 d b e s p e o i f 1 e d a s * 



CURRENT 
BASE 

IS BASH- 
FOR OUT- 
PUT OF 
NUMBERS 



FOR 

NUMBER 
INPUT 
BASE 
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GIMEN 

DFFAUL T 

IS 

DECIMAL 



:l. X 



n t m 



This means the number - 1*256 + 0* Note that since no RIVES 

b a s e w a s s p e c i f i e d ? D I S K A T E a s s u m e s d e c i m a I * f c o u r s e n JK 2 5 6 •{• m 

n i..i m b e r s i n h e x a d e c i m a 1 d o n o t n e e d t o b e s p I i t ? <;> :i. n c e < S P LI T 

t h e h e x a d e o 1 m a I f o r m i s " n a t u r a 1 1 y " s p II. :i. t a I r e a d y * F R M ) 
Numbers in hex are indicated by adding the character "H" 
a s a s u f f i x t o t h e n «..i m b e r * T h e n u m b e r 1. * i s e o u i v a I e n t 
to t 

1.00H 



in hex* 

T o s p e c i f y a n u m b e r i n o c t a 1 * o y* b a s e 8 ? t h e s u f f :i x " 0. " 
is added to the end of the number* So? for example the 
numbers* 



SUFFIX 
H FOR 
HEX? 

Q FOR 



D I S K A T E U ser' s M a n u a 1 



-51. 



2000H 
40 J 000Q 
32 * 

a 1 I s p e e i f y t h © s a m e n u m ta e r ? w h i. o h :i. s 3 2 * 2 5 6 * T h e r e :i. s 
one important point about hex numbers* A HEXADECIMAL 
NUMBER MUST BEGIN WITH A DECIMAL DIGIT* Otherwise there 
would be difficulty distinguishing it from a variable 
name* Thus FFFFH is not a valid way to specify a number 

for D I SKATE you would have to use FFFFH* 

The current base can be changed at any time by 
u s i n «f t h e B c o m m a n d ♦ F o r i ns t a n c e v t o c h a n s* e f r o m 
hexadecimal to octal you would use the command* 

BS 

W h e n t h e c u r r e n t b a s e i s n o t h e x a d e e i m a I ? o u t p u t s a f 

n u m e r i c c o d e s f r o m 1 S K A T E w i 1 1 a I w a y s b e i n s p I i t f o r m * 

As mentioned briefly in the previous section? num- 
b e r s e a n b e u s e d t o s p e c i f y a n i n t e r\/& 1 e x p I i c i t .1. y ♦ F o r 
i n s t a n c e v the f i r s t 8 K b w t e s o f m e m o r y c a n b e s p e c i f i e d 
b y t h e i n t e r v a I s t 

0**:I.FFFH 
0**37? 3770 
0**31 t255 
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HEX NUM- 
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BEGIN 
WITH 
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CURRENT 
BASE 



COMMAND 



To view an interval in memory in numeric* rather than 
ASCII form? the # command may be sliven* It works like 
the H command y except that interval siiven as the 
argument is output byte by byte in numeric form in the 
c u rr&n t b a s e ♦ For e a c h I i n e of o u t p u t t h e r (•? w i 1 1 a I s o 
be a field at the left of the printout showing the 
a d d r e s s of t h e f i r s t b y t e b e i n $ p r i n t e d o n t h a t I i n e ♦ 
The # command will thus perform a CORE DUMP to your 
terminal of the interval *-iiv®n as the argument* 

Arguments i^iveri with the •# command may call for 
match insf? Just like so many of the ones we saw in the 
previous section* The # command is especially useful 
for viewing n on-- print in .3 control characters if these 
m u s t b e u s e d ♦ S u p p o s e v f a r i n s t a n c e » y o u s u s p e c t t h a t 
t h e r e i s a rt o n - p r i n t i n «{ c h a r a c t e r i n t h e I i i"i e :i. n t h e 
current file containing the target character* The 
command * 

*"% 



DUMPS 
INTERVAL 
TO 

TERMINAL 
BYTE BY 
BYTE IN 
CURRENT 
BASE 



w i 1 1 d u m p t h i s I i n e o n t h e t e r m i n a 1 9 a n d y o u c a n i n s p e c t 

the codes to try to find out where there may be a Encodes* 

trouble spot* 

You can also use the E command to enter numeric ENTERS 
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codes as well as ASCII characters* When entering text NUMERIC 

usiniS the E command v the ASCII characters comprising the CODES 
text bvb surrounded by brackets* To enter numeric codes 

using the E command* the codes are surrounded by the CODES 

character " #" and separated by blanks* In this case the MUST BE 

base must NOT be given the base is automatically IN 

assumed to be the current base* A str in** of codes sur- CURRENT 

rounded by the # symbol can also be concatenated with BASH" 

other valid arguments of an E command to form a eompo- WITHOUT 

site argument* The E command is one of those that works Q OR H 

differently if the target character is outside of the SUE FIX 

s o 1..1 r o e a r e a * W h e n t h e E c o m m a n d w a s i n t r o d u o e d i t w a s S E P A 

explained that it will INSERT the entered text into the RATED BY 

o i .! r r e n t f i I e b e t w e e n t h e t a r g e t e h a r a c t e r a n d t h e B I... A N K S 
previous character* However? if an E command is given 
and THE TARGET CHARACTER IS OUTSIDE THE SOURCE AREA* the 
bwtes entered WILL OVERWRITE whatever is there and there 
w i 1 1 b e n o i n s e r t i o i"i * 

L e t ' s I o o k a t a n e x a m p I e ♦ S u p p o s e 1 o e a t i o n 2 D H 

contains a Jump to an output routine for your terminal y IF "* 

but you want to change the Jump to a Jump to location OUTSIDE 

3 7 A H ♦ F i r s t we c a n e x a m i n e t h e p I a c e w e w a n t t o o h a n g e S U R C E 

using the # command J AREA 

#200DH* *<t-2 E 

COMMAND 
T h i s w :i. 1 1 s h o w u s t h r e e b w t e s b e g i n ri :i. n g w i t h 2 D H * (We W I L L 
want to look at 3 bytes because the Jump instruction is OVER-- 
t h r e e b y t e s 1 o n g * ) W e ' 1 1 a s s u m e t h a t t h e o u r r e n t b a s e W R I T E 
is 16* In response to the # command? D I SKATE would print NOT 
o n t h e t e r m i n a I s o m e t h 1 n g I i k e * IN S E R T 

200D C3 03 29 

T h e C 3 i s t h e o p o o d e f o r t h e J M P 1 n s t r u c t i o n v a n d t h e 
Jump is to location 290 3H* (Remember that 8000 instruc- 
tions put the low order byte of an address at the low 
o r d e r I o c a t i o n * ) T h e 3 w e w a n t t o 1 e a v e a 1 o n e y b u t t h e 
two bytes 03 29 we want to change to 7 A 30* Just as we 
d i d w h e n e n t e r i n g t e x 1 9 t o u s e t h e E c o m m a n d t o e n t e r 
numbers we first have to set the entry pointer* The 
command to do the whole Job is** 

~200EH>E#7A 30* 

Note that we saw ~ 200 EH instead of " W 200DH because at 
200DH is the opcode C3 which we don't want to change* 

Obviously it should go without saying that if you 
use D I SKATE as a monitor as in this example:*!' and then go 
b a c k t o e d 1 1 i n g a s o u r c e f i 1 e h a v i n g f a :i. I e d t o r e s t o r e 
the entry pointer to the right place back inside the 
source area 9 a total disaster could result* Entering 
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t e x t f o 1 1 o w i n g a m o n :i. t o r u s a g e s u c h a s w e J u s t s a w 
without having restored the entry pointer could very 
w e 1 1 d u m p " g a r b age" o n t o p o f p a r t o f the r e s i d e n t 
softwarev which could certainly result not in merely 
gar paging up your source file but in a total crash which 
c o u 1 d w i p e o u t the o o n t e n t s o f t h e e n t i r e m e m o r y ! ! ! 
Once again * always be sure the entry pointer is in the 
right place before beginning to edit* 

You can use the E command with numeric codes rather 
t h a n t e x t i n e d i t :i. n g s o u r c e f :i. 1 e s a 1 s o * n c e u p o n a 
time we promised to show a method for entering into a 
t e x t f i. 1 e u n b a 1 a n c e d b r a c k e t s * T h i s e a n b e d o n e b y 
using an F command with the numeric code for the bracket 
rather than using the E command with ASCII text* The 
commands 

E # :l 3 3 # ( i f t h e c u r r e n t b a s e i s 8 ) 
E # 5 B # ( i f t h e o i. 1 r r e n t b a s e i s :l. 6 > 

for instance will enter a left bracket* 

You can also use a seouenoe of numeric codes ♦codes* 
e n o I o s e d i n # ' s ? w i t h e a c h n u m b e r s e p a r a t e d b y a b I a n k m 

a s p a y* t o f a r g u m e n t s e a 1 1 i n g f o r iyi a t e h i ri g * T h e p a 1 1 e r n ♦ A R G ( I M E N T 

THAT 

♦numeric code seeuence* MATCHES 

SEQUENCE 

where numeric code sequence is a seeuence of numeric OF CHARS 

c o d e s i n t h e c u r r e n t b a s e s e p a r a t e d b y b 1 a n k s v w i 1 1 W I T H 

match a seeuence of characters having the same value in VALUES 

the current base as given codes* There are many ways MATCH I NO) 

this can be used* Suppose for instance you have a y^Ibcb codes 
of text which was created using another Y^i^v.^* of 
software and each line concludes with a carriage return 
f o 1 1 owe d b y a 1 i n e f e e d ♦ T o d e I e t e t h e I i n e f e e d s y o u 
can use the command J 

B:l.6?R-:l. yQE#D A#!>?K 

Here the pattern #D A# matches the characters carriage 
r e t urn? I i n e f e e d s i n c e w e m a d e s u r e t h e c u r r e n t b a s e 
was 16* Thus *D A# ! > matches a line feed at the &\id of 
a line? and this command will get rid of all of them* 
f c o u r s e ? s u c h c o m m a n d s c a n b e e a s i I y t u r n e d i i"« t o e d i t 
macros if you are going to use them frequently* 

One of the main differences between using D I SKATE 
as a monitor and using it as an editor is that in using 
i t a s a m o n i t o r y o u w i 1 1 t e n d m o r e t o i..i s e ri »..i m e r i c v c o d e s 
and explicit addresses* In this regard it is important 
to be able to know the explicit address for constructs 
that we specified before by matching and such symbols as 
<F>y <jr etc* The D I SKATE ? command will print on the ? 
terminal in the current base the lower and upper add res- COMMAND 
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ses of the interval given* For instance 9 it hou want to 

know where the source area is in the memoryu type the PRINTS 

c o m in a 1 "1 d * U P P E R 

AND 
?<S> LOWER 

ADDRESS 
I. . i k e w i s e ? < F > w :i. 1 1 g i v e y o u t h e 1 o e a t i o i"i o f t h e c u r r e n t F 
f i 1 e ♦ 1 1 i s s t r o n g 1 y r e c o m m e n d e d t h a t w h i 1 e y o u a t v e I N T E R v* A I... 
editing you give such commands from time to time to make GIUEN AS 
sure the source ar^a is not getting too big* There is ARGUMENT 
n o b U i 1 1 •••• i n p r o t e e t i o n t o p r e v e n t t h e s o u r c e a r e a f y* o m 
o v e r f 1 o w :i. n g t h e a c t u a 1 a m o u n t o f R A M y o u h a v e v b u t b y 
giving a ?<S> command from time to time you can find out 
how big the source area is getting and save your file on 

the disk before things get out of hand* If you detey 

m i n © t h a t a f i 1 e i s i n d a n g e r o f g e 1 1 i n g t o o b i g 9 y o u 
can save part of it on the di sky kill that part and then 
g o o n e d i t i n g t h e r e s t ♦ T h e c o m m a n d s f o r w o r k :i. n g w i t h 
the disk ar& discussed in the newt section* 

The ? command can also be used to find out the 
value of a variable* Remember that a single address is 
interpreted by DT SKATE as an interval where both 
addresses are the same* So for instance if X is a 
var i a b 1 e 9 t h e c o m m a n d ♦ 

?X 

w i 1 1 p r i n t o n t h e t e r m i n a 1 t h e v a 1 u e o f X t w i c e 9 s i 1 "1 e e 
■it interprets X as an interval where both addresses 
eeual the value of X* 

Note that this can be used to count the number of COUNTING 

o c c 1..1 r r e n c e s o f a p a 1 1 e r n i n a 1 e w t f i 1 e * S u p p o s e f o r NUMB E R 

instance* that we are writing a piece of prose and we OF TIMES 

get the sneaking suspicion that we are using the word A 

■ h o w e v e r ■ t o o o f t e n ♦ I... e t ' s s a « t h e c u rre n t b a s e i s :l. 6 ♦ P A T T E R N 

T h 0? c o m m a n d s ♦ (!) G G U R S 

B 1 9 X^O 9 "<F> 9 R -1 9 OF" * * J Chowever II v ' l > y X«X+1 
?XtM6 

w i 1 1 v e s t o r e t h e c u rre n t b a s e a f t e r p r i n t i n g o n t h e 

t e r m i n a 1 ( i n s p 1 i t d e c i m a 1 ) t h e n »..i m b e r o f t i m e s t h e word 

however occurs in the current file* 

Of course y not only will you need to know where 

various things btb in the memory 9 you will need to be COMMAND 
able to put things where you want them* When you bring 

up D I SKATE :ft will have an initial value for where the ORIGIN- 

source area is to go in the computer's memory* Suppose ATES 

you want the source area somewhere else? This can be NEW 

achieved with the command 9 which stands for Originate SOURCE! 

new source area* When the command is given with an AREA 

argument? the interval comprising the argument is est ah- AT 
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1 :i. s h e d a s t h e s o u r e e area* A is wr :i. 1 1 e n a t t h e u p p e r T N T E R v" A I... 

and lower address of the interval to form the boundaries GIVEN 
of the source areav unless the upper and lower addresses 
a r e e o u a 1 ♦ I n t h i s c a s e t wo c o n s e c u t :i. v e ' s a re w r :i. 1 1 e n 
at this address to establish an empty source area* 

Nothing is changed in the old source area unless the WITH NO 

argument of the command overlaps it* in which case the ARGUMENT 

O's written will overwrite something there* What is CREATES 

changed av^ DISKATE's internal pointers to where the EMPTY 

source bvbb is* Uhen the command is executed ? the SOURCE 

LAST file in the new source area is made current* and AREA 

the target character is set to the giving the Grid of STARTING 

t h e f :i. 1 e * f c o u r s e * t h i s f i 1 e m i si h t b e e m p t y * S A M E 

The command can also be given without arm argu- PLACE AS 

m e n t ♦ I n t h i s c a s e * r a t h e r t h a n f o 1 1 o w i n g t h e s t a n d a r d C U R R E N T 

procedure of using the last argument computed* an empty <S> 
s o i..i Y" e e a r&a w i 1 1 b e e s t a b 1 i s h e d b e g i n n i n g a t t h e s a m e 
place that the current source area begins* This is very 
u s e f i..i 1 f o r " s c r u b b i n g " t h e w o r k y o u ' v e a 1 t v e a d y d o n e a n d 
starting with a clean slate to bring in a new file from 
the disk* 

Using the command you can maintain several dif- 



ferent source areas in the memory 
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you want to create a new source area at a special 
1 o c a t i o n w h i c h w i 1 1 b e u s e d b y a p i e c e o f s o f t w a r e t h a t 
reouires a file in a particular place* If you want to 
be able to go back to the current source area* you can 
save its location by* 

0LDS0URCE1"<S>*0LDS0URCE2*:> 

The new source area can be set up using the command* 
a n d i f y o u w a n t t o <•* o b a e k t o e d i t i n si t h e o 1 d s o u r c e 
a r e a t h e c o m m a n d * 

0LDS0URCE1. * * 0LDS0URCE2 



w i 1 1 r e e s t a b 1 i s h i t a s t h e s o u r c e a r e a ♦ 

The command is what you want if you want to ere- M 

ate a fresh source area somewhere in memory other than COMMAND 

where D I SKATE wants <S> to be* or if you want to make a UPDATES 

given interval into the source area* But what if you POINTERS 
want the whole source area as it already exists to be 

moved somewhere else? The D I SKATE M command* which E*G* 

we've a 1 r e a d y i n t r o d u c e d * i s a e t u a 1 1 y a n e x t r e m e I w f 1 e x - M < S > 

i b I e and powerf u I c o m m a n d a n d can very e a s i 1 y a e c o m p I i s h D E S 

moving whole blocks of memory — not only moving the MOUE % 

actual bytes but also changing the internal D I SKATE UPDATES 

p o i n t e r s s o t he c h a n g e w i 1 1 b e p r o p e r I y k e p t t r a c k o f * < S > * < F > 
Suppose for instance that your source area begins at 
2A00H and you have done some work editing a file* Now 
you dt^cidts you want to consult a BASIC program* which 
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n e e d s t h i s a r e a o f m e mora* f c o u r s e w o u r f :i. 1 e c o u 1 d 
be saved on the disk and then reloaded? but perhaps, 
the BASIC program is able to examine the file and you 
want the file still to be in memory for speed reasons ♦ 
Let's saw that a block beginning at 700 OH is free and 
big enough to hold the file* The single command* 

" % 7000H?M<S> 

w i 1 1 m o v e t h e e n t i re source are a t o 7 H ? a n d u p d a t e 

■t h e p o i n t e r s d e 1 i m i t :i. n g b o t h < S > a n d < F > ♦ T h e M e o m m a n d 

is another which behaves differently if the entry 

p o i n t e r 1 i e s o u t s i d e t h e s o u r c e a r e a ? w h i c h h e r e i t 

c e r t a i n 1 y d o e s ♦ T n s u e h a c a s e t h e :i. n t e r v a 1 t o b e m o v e d 



is simply COPIED to 
t h e t a r g e t c h a r a c t e r ♦ 
used to be at the 
c o p i e d i s s i m p 1 y 



is NOT deleted from anything? but 
the area of memory beginning with 
There is no insertion — whatever 
interval to which the argument is 
overwritten* 

There is a special case of using the M command with 
an interval outside the source ar&a which may save you 
some trouble* When you are using the editor? deleting 
t e x t «..» s i n g t h e K e o m m a n d a c t u a 1 1 y w o r k s i n t e r n a 1 1 y b y 
calling the routine invoked by the M command* The 
INTERVAL TO BE DELETED IS MOVED IMMEDIATELY OUTSIDE THE 
SOURCE AREA? and* in the event that you change your mind 
and want back the interval deleted? it can be recovered 
if the source area has not been enlarged* However? the 
deleted text is NOT surrounded by 0"s? so it may cause 
some trouble in general to determine Just what the 
boundaries are for this piece of text* 

However? if you act fast enough you may be able to 
recover deleted text with very little trouble* The M 
command updates all internal D I SKATE pointers that it 
knows about? which includes < and >♦ After a Move 
c o m m a n d ? t h e s e t w o p o i n t e r s w i 1 1 g i v e t h e I o c a t i o n T 
WHICH THE INTERVAL HAS BEEN MOVED* Since the K command 
i s s u e s a n i n t e r n a I c a 1 1 t o t h e M c o m m a n d r o u t i n e ? 
immediately after a K command < and > give the lower and 
upper addresses respectively of the area in memory to 
which the killed text has been moved* Thus? if you give 
a K command? and then IMMEDIATELY afterward realize that 
it was a mistake? GIVING THE M COMMAND WITH NO ARGUMENT 
JUST AFTER THE K COMMAND WILL RESTORE THE DELETED TEXT* 

Suppose you delete an interval with a K command? 
and then decide you want the deleted text back but only 
after you've already given a command after the K coro- 
in a n d ? s a y a " ♦ ♦ T h e t e x t c o m p r i s i n g t h e i n t e r v a 1 w i 1 1 
s t i 1 1 b e J u s t o u t s i d e t h e s o u r c e a r-^a? u n I e s s t h e c o m •- 
m a n d ( s ) y o u g a v e a f t e r t h e K c o m m a n d e n t e r e d t e x t * T h e 
deleted interval can be moved back to where it should go 
i f a way c a n b e f o u n d t o s p e c i f « t h e r i g h t i n t e r v a 1 * 
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The first thins to do is to SAVE THE ENTRY POINTER by 
giving a variable-" 1 command* Unless you have given a 
command after the K command which changes the entry 
p o :j. n t e r v i t w i 1 1 p o i n t e x a c 1 1 y t o t h e p 1 a o e wher e t h e 
text is to be put back* Suppose you know that you 
deleted 3 lines* In this case the interval of the 
deleted text can be specified by the argument* 

o ♦ ♦ ••- .I. I ♦ ♦ o .... 

8 '"' ; :i. s a s y m b o I w h i c h we have n ' t s e e n b e f o r e v a n d :i. t 
denotes the address of the FIRST BYTE BEYOND THE SOURCE 
AREA* What about the -A? The -1. occurs in a position 
where D I SKATE expects an interval argument of some kind? 
which means it is looking for something it can turn into 
an address (or actually a pair of addresses to be 
corr e c t * ) R e in e m b c r t h a t a d d r e s s e s a r e t r e a t e d a s 1 6 b i t 
non-negative numbers* This means that the sign bit in 
-:l. is treated as a digit bit* so -1. is the same as 
6 5535 y which is the highest address in the memory* So? 
t h e a r g u m e n t S " v * * - 1 ! * ♦ 3 .... m e a n s J e v e r y t h i n g u p t o t h e 
3rd carriage return within the interval starting .Just 
beyond the source area and &>it&ndin<$ to the ^nd of 
memory* The deleted text can be restored by* 



"«' 



■1 ! **3. 



GIVES 

FIRST 

BYTE 

BEYOND 

SOURCE 

AREA 



M 



COMMANDS 
TO 

RECOVER 
3 DELETED 
LINES 



In this case the " is given as a precaution* to 
make sure we're getting what we want? and saving the 
e n t r y p o i n t e r w a s a p r e c a u t i o n w h i ch was n ' t r e a 1 1 y 
necessary* However * in general you may not be sure how 
to specify the deleted text* In this case you may want 
to give " or # commands to try to pin down exactly where 
the upper bound is of the material that was deleted* and 
b e i n g a b 1 e t o s e t t he entry po i n t e r m i^h t b e u s e f u I ♦ 1 n 
g e n e r a 1 ? i f y o u c a n f i g «..i re o u t a p a 1 1 ern w h i c h w i 1 1 
match the ending of the interval you want back* the 
commands* 



« e 



1.1* ♦ pattern 



M 



will put you back on the track* Note however that you 
must set the initial refBrencB interval by an argument 



such as S' 



;l. y s i n c e m a t c h i n g w i 1 1 a 1 w a y s f a i 1 o u t s i d e 



the source area unless the initial reference interval 
has been set* 

There may be instances where you want to perform a 

block move but you don't want D I SKATE to know about it* COMMAND 
For instance* it may be useful to have a separate copy 

i n the mem o r « o f a 1 1 t h e f i 1 e s i n the s o u vcb area* T h i s C P I E S 
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can he achieved by using the C command ? C for Copy? INTERVAL 

which works similarly to an M command with the target GIVEN AB 

character is outside the source area* The C command ARGUMENT 

copies the interval given as argument to the memory TO BYTES 

locations beginning with the target character* Whatever STARTING 

used to be at the block beginning with the target WITH 

character is simply overwritten* The C command works the TARGET 

same whether the target character is in the source area CHAR 
or not? and does not update any of the D I SKATE internal 

pointers as does the M command* Thus if you give the NO 

command ":l.000H? and this location is outside the current POINTERS 

source area? the difference between* UPDATED 



M<S> 



C<S> 



and 



i s t h a t a f t e r t h e M < S > t h e e u rve n t s o u r e e a r e a w i 1 1 
begin at 1000H? the pointers to <S> having been updated ? 
whereas after the C<S> command the source area will be 
exactly where it was before the command* You should be 
fairly careful in using this command? since it would be 
easy to overwrite a part of the memory D I SKATE is using 
f o r s o m e t h i n g e 1 s e ♦ 

As you might suspect by now* the K command also 
works differently if its argument is outside the source 
area* In this casev rather than removing the interval 
g i v en a s t h e a r g u m e n t ? t h e K c o m m a n d w i 1 1 Z E R t h i s 
i n t e r v a 1 ♦ lev o i n g a b I o c k o f memory c a n b e e s p e c i a 1 1 « 
useful for machine language programming? where you may 
w a n t t o b e s u r e t h at a p r o g r a m w h i c h i s s t i 1 1 b e i n g 
debugged is only modifying those areas of the memory 
that it's supposed to* By zeroing a large block of 
memory before you begin work? you can easily see with 
the # command whether a program has dumped garbage in 
the wrong place* This method also makes it especially 
easy to see how much stack is being used* 

The D I SKATE commands discussed in this section make 
D I SKATE the most powerful monitor available for personal 
computers* They can be used in macros? Just as the 
editing commands discussed in the previous section* For 
instance? suppose you wanted to fill a block of memory 
with repetitions of the pattern consisting of SO ASCII 
blanks followed by a carriage return and a line feed* 
Let's say you want to set up 1.00 such lines? beginning 
at location 1000H* The commands* 
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RSO 
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"1.000H 
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B16 
R100 

dc*line:i 

E*.D A# 



will set up a macro which will do this Job and can be 
i n v o k e d b y t h e c o in m and D C * F 1 1... I... .".1 ♦ 

Suppose we want to do the same thing y but we want 
to fill all of the memory available up to 2000M? but 
without overwriting anything be si inning at 2000H* Of 
o o u r s e » w e e o U 1 d c a 1 o u 1 a t e t h e n u m b e r of 1 i n e s t h a t 
would be needed? fisfurinsl 82 bytes per liner and substi- 
tute that for the 100 in the macro above* Another way 
i s t o s e t u p t h e m a c r o t o k e e p e n t e r i n g t h e 1 i n e s u n t :i. 1 
it determines that no more can be added*. We can do this 
with the QF command* There is only one way that QF can 
produce a matching failure if the interval is given in 
t h e f o r m e x p r e s s i o n 1 * ♦ e x p r e s s i o n 2 w he re the two 
expressions do not involve matching* in the case that 
the value of express! on .1. is greater than the value of 
expr ess ior»2* Using this fact* we can modify the 
c o m m a n d s a b o v e a s f o 1 1 o w s 



» ♦ 



NvEr:*L!NE 
R80 

ec :i 

lyNvEOKFILL 

/% 1000H 

B16 

R-l 

QF^+Sa **2000H 

di::*line::i 

E#D A* 



T h i s m a c r o w i 1 1 k e e p o n e n t e r 1 n g t h e 1 i n e s u n t i 1 t h e 
entry pointer comes within 82 bwtes of the av&a we want 
t o 1 e a v e a 1 o ne» i n w h i c h c a s e i t w i 1 1 o u i t ♦ 

U sin g t e c h n i a u e s s u c h a s t h i s t h e r e i s n o 1 i m i t t o 
t he f 1 e x i b i 1 i t y t h a t D I S K ATE w i 1 1 a How* A g a i n v a s s o 
often in this manual y it must be emphasized very 
emphatically that after using DI SKATE as a monitory if 
you want to resume editing text already established in 
the source area you must be absolutely sure the entry 
pointer has been restored in the ^roptsr place* 

To conclude this section we introduce a command by X 
which you can call machine language subroutines from COMMAND 
DISK ATE* The X command y for eXecutey will issue a CALL 
to the lower address of the argument given* This can of ISSUES 
course be either an explicit address or a more complex CALL 
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expression ♦ If the machine lan«H.ia«*e subroutine is TO 

properly written %nd exits with one of the 8080 return MACHINE 

i n s t r u c t i o n s * a c a 1 1 t o i t b « a n X c o m iti a n d c a n b e L A N G U A BE 

included in a command line or macro mv:i the rest of the SURROU*- 

c o m m a n d 1 i n e or m a c r o w i 1 1 b e e x e c u t e d u p o n ret u r n ♦ I f T I N.E A T 

the address given is a program which sloes into its own LOWER 

loop and does not return* such as a BASIC or DOS? then A DP RES 8 

the X command will serve as a Jump command* since such a OF 

program will certainly intialize its own stack* The INTERVAL 

d e t a i I s o f h o w t o w r i t e m a c h i n e I a n <■& u a <$ e p r o «* r a m s f o r 1 V E N 

i ri t e r f a c i n $ t o D I S K A T E a r e d i s c u s s e d i n P a r t 1 1 ♦ H e r e ' s A S 

a n e x a m p I e o f u s i n «< t h e X o o m m 3 n d * I f y o u ' r e u s i n $ A R 8 U M E N T 
DISK ATE with software that locates a DOS entry point at 
2028M* you csn get back to the DOS from D I SKATE with the 
command * 

X2028H 

If you want to do this frequent ly you can set a varia- 
ble* saw DOS* ewual to 2028H and then use the command* 

XDOS 

This method is highly recommended* since (as with any 
J u m p c o m m a n d ) if y o u m a k e a m 1 s t a k e t y p i n «$ a n e x p 1 i c i t 
address for the X command a system crash could result* 
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1*3 U s i n si D I S K A T E i n p u t / o u t p u t 



In this section we'll, deal first with terminal X 
handling and then talk about how to use the disk com- 
mands* All of the I/O in DISKATE is handled through 
c a 1 1 s t o 1 o c a t i o n s i n a J u m p t able* so t h a t a ny t w p e 
terminal can be interfaced to DISKATE* The details o 
how to do this are discussed in Part II of this manua 
For the moment all we need to know is the general str 
ture of how DISKATE handles the I/O calls* The termi 
I/O routines involve calls to the following basic 
drivers* 



/0 



of 

f 

1* 

I..IC- 

nal 



.1. ♦ A r o u t i n e t o i n i t i a 1 i z e t h e t e r m i n a I ♦ 

2* A routine get one character of input? presumably 

from the keyboard? and return it in the A register* 

3* A routine to output one character from the B 
r e g i s t e r t o t h e t e r m i n a I ♦ 



4* A "panic detect" routine* This routine Queries the 
terminal to see if a kew has been pressed* If not 
it returns ? with a flag set to indicate nothing is 
doing* Otherwise? if a key has been pressed it 
inspects the bwte corresponding to the Mew? and if 
it meets the conditions set bw the user to indicate 
that a process should be stopped? it returns with a 
flag set indicating this* Otherwise it returns with 
the flag set as before indicating nothing doing* 

The basic terminal input and output routines can 
handle multiple I/O devices* When the routines are 
called? a device number is supplied in the A register* 
The routine can use this number to vector the call to 
one of several devices* Normally calls are made to 
device — i*e* is in the A register when the 
terminal routines are called* The devices number can be 
changed be giving an 10 command* The command i 



10 
COMMAND 



10 n 

will cause n to be henceforth passed in the A register 
to the t e r m i n a I I / r o u t i n e s ? so t h a t a 1 1 o f t h e t e r m i n - 
al I/O from the time the 10 command is executed will go 
to device n instead of device 0* Also? when this com- 
mand is executed? a carriage return and line feed will 
be printed on the device — i*e* the output routine will 
be called with the new device number irt the A register 
first for carriage return? and then for line feed* 

Here is how this can be used* Suppose you have 
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both a video terminal and a printer* and your drivers DEVICE 
are set up so that when the output routine is given a 

a 1 1 t o d e v i e e i t p r i n t s o n t h e v i d e o term i n a 1 ? ta u t 
device .1. prints on the printer* To get a hard-oopw 

1 i s t i n g o f t h e c u r r e n t f i 1 e y o u e o u 1 d g i v e t h e e o m m a n d * 

10 1 ? H **?I0 

This would cause the " ♦ ♦ command to send its output to 
device 1? following which printout is restored to the 
video terminal taw the 10 command * 

The 10 command applies to both subsequent input arid 
output* If your printer does not have a keyboard? your 
input driver should be set up so that it gets the call 
no matter what the device number is* Otherwise? if you 
forget to give an 10 command at the end of a command 
s t r i n g o o n t a i n i n g a n 10 1 ? f o r i n s t a n c e ? D I S K ATE w i 1 1 b e 
u n a b 1 e t o g e t a n y i n p u t ♦ T h e 1* e o m in a n d c a n a 1 s o b e 
given an argument other than a constant* The command* 

10 DEVICE 

would supply the value of the variable DEVICE as the I/O 
d e v i c e n u m b e r ♦ Y 

If you don't have multiple input or output devices? COMMAND 
your terminal routines can simply ignore the device num- 
ber in the A register? and this discussion won't apply* EXECUTES 

You can execute the terminal initialization routine TERMINAL 
a t a n y t i m e b y g i v i n g the Y e o m m arid? ( Y f or ■ W i p e " ? ) INI T I A I ... •••• 
which takes no argument* A device number is p resented IZATI0N 
to the terminal initialization routine as for any of the ROUTINE 
other terminal 1/0 routines* If you have multiple 

devices? you may want your terminal initialization (NO ARG) 
routine to initialize all of them at once? or you may 
w a n t i t t o i n t i a 1 i z e o n 1 y the d e v i c e w h o s e n u m b e r i s 
p a s s e d t o it* If y o u d o i t t h i s s e c o n d way? t h e n w h e n - W I D 
ever you use a new device by means of an 10 command? you COMMAND 
w i 1 1 have to rem e m b e r to g i v e a Y c o m m a n d u n 1 e s s t h e 
d e vice nee d s n o i n i t i a 1 i z i n g ♦ A 1 1 t h i s :i. s d i s c u s s e d S E T S 
more fully in 11*1* TERMINAL 

A n o t h e r c o m m a n d p e r t a i n i n g t o t h e t e r m i n a I allows w* I D T H 
you to set the terminal width* This is the WID command* TO ARG 
I f y o u g i v e the WID c o m m a n d w i t h n o a r g u m e n t ? :i. t w i 1 1 
print the current terminal width? while if you supply an WITH NO 
argument? the low order byte of the value of the argu"~ ARGUMENT 
ment will be set as the terminal width* The widest line PRINTS 
which the line buffer can hold is 130 characters? though TERMINAL 
i f a W I D c o m m a n d i s give r» for a v a 1 u e g r e a t e r t h a n t h is? W I D T.H 
the value will be set as the width of the terminal for 
output purposes* This width determines how many charac- 
ters are output before D I SKATE automatically inserts a 
cavr i age ret u r n a n d I i n e feed f o r a n o v e r f I o w I i n e ♦ 
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The Panic Detect State is important so we'll spend 
a minute discussing it in detail* The panic detect 
routine is called periodically by DISKATE? including 
PRIOR TO THE OUTPUT OF EVERY BYTE TO THE TERMINAL* In 
the version supplied with DISKATE which is written for 
the serial I/O port on the disk controller? the panic 
detect routine will respond to ANY KEY ON THE KEYBOARD 
BEING PRESSED* Because there are timing considerations 
involved* the best way to register the panic state to 
D I S K ATE :i. f y o u "re u s i n g the pb n i c d e t e c t r o u t i n e 
provided is to press the Break key if your terminal has 
one* (These details are discussed more fully in Part 
II*) I f you btb w r i t i n g y o u r own p a n i c d e t e e t ? y o u m a y 
wish it to respond to only a certain character? such as 
a Control-C* In any event? if the panic detect routine 
returns to DISKATE signalling the condition that you 
desire a process to be stopped? DISKATE will STOP AND 
WAIT FOR THE NEXT CHARACTER TO BE INPUT FROM THE 
KEYBOARD* 

If this character is ESC? (1.BH) then the ongoing 
DISKATE process will be TERMINATED* A Question mark 
will be printed on the screen to echo the abort* If you 
type S instead of ESC? (S for Single-step?) the next 
character of the output will be printed but the panic 
state will remain in effect* Thus a single character 
will be printed? but prior to the output of the newt 
character DISKATE will automatically go into the panic 
state as if you had again interrupted it* Thus if you 
want to slow down a printout? interrupt it by invoking 
the panic detect routine? and then repeatedly type S? or 
if your terminal will transmit a character repeatedly? 
transmit the S* This way the characters will be printed 
slowly enough for you to be able to read them as they 
are being printed* If you are in a panic state and you 
type any character other than S or ESC? the process will 
continue full steam* Recall that you can force entry to 
the panic state by executing the PAUSE command* 

If a printout from a " command is interrupted by 
invoking the panic detect and then aborted? there is a 
way to continue the printout where you left off* The 
symbol ■?■ can be used as an argument and will give the 
address within the file where the output was halted* 
For instance? if you abort a "♦♦ command and then decide 
you want it to go ahead and finish? the command* 

r ♦ ♦ 

will work* In general? if you've given no commands 
since aborting the printout? you can use the command* 
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to resume? the printout and have it continue to whatever 
upper bound you orignally specified* This feature is 
implemented only for the " command? and will not work if 
a # command is similarly interrupted* 

As we mentioned at the beginning of the manual? BAOK- 

D I S K A T E scans its i n p u t and if t h e b a c k -space k e y ? 8 H S P A E 

or Oontrol~H? is pressed* the pointer to the line buffer WIPES 

holding the line currently being typed is backed up one GUT 

character? and the following is echoed to the terminal* LAST 

a back-space? a space? and another back -space* If you CHAR 

a r e u s i n g a v i d e o t e r m i n a 1 t h i s w :i. 1 1 e r a s e t h e 1 a s t T Y P E D ? 

character typed from the screen* You can do this any ESC 

number of times to wipe out several characters that have WIPES 

bo? en typed that contain mistakes* If you type ESC then OUT 

t h e e n t i r e I :i. n e i s ignored* A b a c k s I ash? " \ " ? i s p r i n t e d C U R R E N T 

on the terminal to echo this* LINE 

T h e d e t a :i. 1 s for ere a t i n g the a c t u a I d rive r s t o han- 
dle these I/O calls are discussed in Part II* At this 
point we are ready to begin discussing the disk file 
h a n d 1 i n g c o m m a n d s ♦ In t e r n a 1 1 y D I S K A T E i s d i v i d e d i n t o 
two parts? a program called 10? which has all of the 
d i s k ban d 1 i n g r o u t i n e s and other i n p u t / o u t p u t ? a n d a 
program called ATE which is independent of ann particu- 
lar I/O requirements* D I SKATE comes with drivers for 

h a n d 1 i n g b o t h t h e D i s k J o e k e y c o n t r o 1 1 e r a n d t h e N o r t h D 1 S K 

Star Disk* However? if you have another controller? it PILE 

is possible to interface? that controller to D I SKATE by SPEC I - 

rewriting part of the module 10* PIED E<Y 

A disk file is named by a combination of the file FILENAME 

name and a designator which indicates which drive the COLON 

file is on* DISKATE maintains a CURRENT DRIVE* and the DRIVE 
disk drive designator can be omitted when specifying a 

f i I e ? i n w h i c h c a s e t h e f i 1 e w i 1 1 b e a s s u m e d t o b e o n D R I V E 

the current drive* File names may be up to S characters OMITTED 

long and can contain ANY PRINTING CHARACTERS EXCEPT: a ASSUMES 

c o m m a o r c o 1 o n ♦ In a d d i t :i. o n ? t h e f i I e n a m e m u s t n o t C U R R E N T 

begin With " or (»♦ The disk drive designator is a DRIVE 
s i n g I e I e 1 1 e r ? A thro u g h H ♦ I n t h e c u r r e n t v e r s i o n ? 

drives A through D are vectored to routines for the Disk DRIVES 

J o c k e y c o n t r o 1 1 e d d r i v e s 1 t h r o u g h 4 ? d rive s E ? F ? G a r e D E S I G - 

v e c t o r e d t o r o u t i n e s for N o r t h S t a r D i s k d r i v e s 1 ? 2 ? 3 ? N A T E D B Y 

and drive H is undefined* To specify the disk dri\/e LETTER 
a 1 o n g w i t h t h e f i I e name? the f i I e n a m e i s g i v e n 

f o 1 1 o w e d i m m e d i a t e 1 « b « a c o 1 o n f o 1 1 o w e d b w t h e d r :i. v e A - D D I S K 

d e s i g n a t o r ♦ T h u s a f i. I e n a m e d C N T R A T o n D i s k J o e k e y J C K E Y 

drive 2 could be specified* E-G NORTI 



STAR 



CONTRACT IB 

I n y o i. j r v e r s i o n o f D I S K A T E a s sup p I i e d ? t h e c u r r e n t 
d r i v e o n power- u p w i 1 1 b e d r i v e A ♦ (I n P a r t II we"! 
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see how this can be changed*) 

Each file has associated with it the following 
information* 



1 ♦ The file name* 

2* The location on the disk where the file resides* 

3* The length of the file* 

4* The file type* 

5* The address in memory from which the file was saved* 

F i 1 e n a m e s we've a 1 r e a d « d i s c u s s e d ♦ D I S K A T E 
assumes that each disk is divided into units called 
BLOCKS which arB 256 bytes long* The block is the 
s m a 1 1 e s t u n i t o f i n f o r m a t i o n f o r d e a 1 i n g w i t h t h e d i s k ♦ 
T h e a c t u a 1 d e t a i 1 s of how char a c t e r s a r e s t o r e d o n t h e 
d i s k are i r r e 1 e v a n t h ere* t h e D 1 S K A T E ta 1 o o k s t r u c t u r e 
can be thought of as a logical construct which does not 
depend on the physical details of the acuta 1 disk con- 
t r o 1 1 e r org a n i z a t i o n ♦ T h e D i s k J o c k e y c o n t r o 1 1 er> f o r 
example)' will rtsad and write information in units of 128 
bytes* The location or address of the filer #2 above y 
is the BLOCK NUMBER of the file on the disk* The length 
is the number of blocks* Thus the smallest file possi- 
ble in D I SKATE is 256 bytes long* The length of a file 
i s a one-byte n u m b e r * so t h a t D 1* SKA T E f i 1 e s ar e L I M 1 T E P 
TO A LENGTH OF 65K? or 256 blocks to be exact* D I SKATE 
recognizes only two file types* source files and non- 
source files* A source file has a type of 0* and a non- 
source file may have an^ other type* The file type is 
given by a one-byte number* When D I SKATE saves a file 
on the disk it automatically sets the file type* Any 
file saved FROM WITHIN THE SOURCE AREA will be assumed 
t o b e a s o u r c e f i 1 e a n d w i 1 1 b e g i v e n t y p e 1 w h i I e any 
other file will be given type 1* 

All of this information is stored in a special 
location on the disk called the DIRECTORY* The direc- 
tory o c c u pies t h e f i r s t 4 b 1 o c k s o n esc h d i s k v a n d e a c h 
file on the disk has an entry in the directory which is 
16 bytes long* The format of the directory is* 



BLOCK « 
256 BYTES 

IS 

SMALLEST 
UNIT OF 
DISK 
STORAGE 



FILE 
LENGTH 
LIMITED 
TO 256 
BLOCKS 



SOURCE 

FILE IS 

FILE 

SAVED 

FROM 

SOURCE 

AREA 



DIREC- 
TORY 
USES 
1ST 4 
BLOCKS? 



byte 


contents 


0-7 


file name 


8-9 


disk address 


10 


file length 


11 


ignored 


12 


file type 



16 BYTES 
PER FILE 



D I S K A T E U s e r ' s M a n i. j a 1 



•AA- 



1.3-14 



m e m o r w add r e s s 



15 



unused 



North Star 1 Disk users will note that this format is com- 
pletely compatible with North Star DOS* In this table 
bytes are numbered with low order bytes getting low 
n u iti ta e r s * a n d a d d r e s s e s f o 1 1 o w t h e 8 8 o o n v e n t i o n o f 1 o w 
order byte in the low order address* Because each entry 
i i "i t h e d i r e o t o r y :i. s 1 6 b y t e s 1 o n g y t h e d i r e e t o y v y h a s 
space for 64 files* Thus each disk is limited to 6 4 
D I SKATE files* 

As with any floppy disk system y a program which 
goes out of control snd manages to dump garbage on the 
directory of a disk MAY RENDER THE ENTIRE DISKETTE 
UNREADABLE!! For this reason you are emphatically 
a d v i s e d t o m a k e b a c k u p s o f a 1 1 d i s k s c o n t a i n i n g i m p o r - 
tant information* If you have a dual disk system? 
backups can be made by copy ins* entire diskettes* 
D I 8 K A T E h a s a o o m m a n d f o r d o i n si t h i s ? w h i e h w e ' I 1 s e e 
below* If you have only a single driv®? you can keep 
"consecutive backups 8 by STORING A FILE ON A BACKUP 
DISKETTE EMERY TIME YOU STORE IT ON THE WORKING 
DISKETTE* If you consider this to be too much of a 
nuisance to be worth the bother v it is a safe bet you 
w i 1 1 c h a n g e y o u r m i n d t h e f i r s t t i m e y o u 1 o s e a w h o I e 
d i s k e 1 1 e w o r t h o f i n f o r m a t :i. o n * 

Now I e t ' s b e g i n t h e d i s c u s s i o n o f t h e f i I e h a n d I i n g 
commands* Suppose you are working on a file which is 
brand new -—• wou started with an empty source area and 
have created the file for the first time us in 3 the 
e d i t o r c o m m a n d s •> a n d n o w i t m u s t b e s a v e d o n t h e d i. s k * 
Let's say you want to save it under the name SPECS* 
This csn be done with the command* 

S SPECS <F> 

T h e D I S K ATE f :i. I e h a n d I i n g c o m m a n d s w i 1 1 d o a I o t o f w o r k 
a i.i t o m a t i c a 1 1 w * sow e h a d ta e 1 1 e r b e c a r e f u 1 t o u n d e r s t a n d 
J u s t h o w t h e c o m m a n d s w o r k ♦ F i r s t o f a 1 1 v s i n c e o n I y 
SPECS was given as the file name? D I SKATE assumes that 
SPECS is to be saved on the current drive* Before the 
command above was given? presumably there is no such 
file as SPECS* No matter v D I SKATE will create the file* 
T h e i n f o r m a t i o n s a v e d o n t h e f i I e i s t h e i n t e r v a 1 w h i c h 
is the second argument of the S command* In this case 
w e ' v e give n t h e e n t :i. r e c u r-re n t f i I e a s t h e a r g u m e n t ♦ 
B e c a u s e < F > i s s u r e I y w i t h i n t h e s o u r c e a r e a ? S P E S w i 1 1 
automatically be given type 0» which makes it a source 
f i 1 e ♦ I n t h e m e m o r y a d d r e s s s e c t :i. o n o f t h e d i r e c t (^ r y ? 
the current address of the beginning of the current file 
will be written? though for source files this informa- 
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tion is generally not consulted* 

Now suppose you do some more work editing the file* 
and want to save the newer version* The identical 
command* S SPECS <F> will save the current file as the 
disk file SPECS* Note that the old contents of SPECS on 
the disk are overwritten by the S command* So* the S 
command will create a new file if there is no file 
corresponding to the file name given as the first 
argument? if there is such a file its old contents avB 
overwritten* Note that this is a great convenience* as 
long as you haven't made a mistake in typing the S 
command* However * it does make it possible to get into 
t h e f o 1 low :i. n g t a n g 1 e * If « o u m a k e a m i s t a k e e n t e r i n g 
t h e f i 1 e n a m e in the S c o m m a n d a n d s f&c i f y a f i 1 e w h i o h 
doe s n ' t e x i sty when y o u m e a n t t o spec i f y a f i 1 e w h i c h 
d o e s e x i s t * the f i 1 e w i 1 1 b e s t o r e d u n d e r t h e i n c o vv&c t 
name* T h i s w i 1 1 have two c o n s e o u e n e e s ♦ there w i 1 1 b e 
an extra file on the disk under an erroneous name? and 
the file with the correct name will not contain the 
1 a t e s t v e r s i o n o f t h e f i 1 e ♦ Bel o w we" 1 1 s e e s o m e w a y s 
to prevent this type of situation* 

One other caution* To specify the current file as 
the interval to be saved* we used the argument <F>* We 
could have used ♦♦ instead of <F>* since like most 
DISKATE commands* the initial reference interval for the 
S command is the current file* Remember* though* that 
if you are using the REF command to specify a different 
i n i t i a 1 reference i n t e r v a 1 * t h i s w i 1 1 a I s o a p p 1 y t o t h e 
S comma n d ♦ We u s e d < F > t o s p e c i f w t he c u r r e n t f i 1 e 
because it gives the current file without matching* 
r e g a r d less of t h e i n i t i a I r e f e r e n c e i n t e r v a I ♦ 

Here's one way of avoiding the problem of saving a 
file under the wrong file name* Whenever a DISKATE 
command is to be given a file name* the symbol M can be 
given in place of the file name and refers to THE MOST 
RECENTLY REFERENCED FILE* Thus if you create a brand 
new file and save it by a command S SPECS <F>* as above* 
and then do some more work on the file and want to save 
the u p d a t e d v e r s i o n as the s a m e f i I e * y o u c a n u s e t h e 
command* 



S 






PROVIDED you have not given an\^ disk commands with other 
file names or changed the current drive in the meantime* 
Even i m m e d i a t e 1 y a f t e r p o w e r - u p * " w i 1 1 have a m e a n i n g * 
since as we'll see below* when DISKATE powers up it 
references a special file called STARTUP* 

If you want to see what the most recent file is* 
you can give the command* 
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RECENT 
T h :i. s w :i. 1 I p r i n t t h e f i 1 e n a m e a n d drive o n t h © t © r m :i. n a 1 ♦ F 1 1 ... E 
U s © o f t h e " f :j. 1 © n a m © p r o v :i. s :i. o n i s h :i. g t r 1 y r © c o m m © n d e d ♦ 

So far we've said nothing about the length of the 
file after an S -command* When the S command is given? 
t h e 1 e n g t h of t h e f i 1 e w i 1 1 b e s © t a t J u s t © n o u g h b 1 o o k s F I L E 
t o hi o 1 d t h © i n t © r v a 1 s a v © d ♦ S u p p o s © t h © f i 1 © a 1 r © a d y L. E N G T H 
exists and the length is not long enough to hold the SET AT 
interval? If there is a contiguous block on the disk JUST 
1 a r g © © n o u g h f o r t h © i n t © r v a I t h a t i s f r © e y D I S K ATE w i 1 1 I... N G 
save the file in this block and re leas© the block where ENOUGH 
t h © f :i. I © © x i s t © d b © f o r © * I f t h © r © i s © n o u g h f r © © s p a e © T H 1... D 
on the disk to hold the interval but not in one block? INTERVAL 
D I S K A T E w i 1 1 c o m p a c t t h e d i s k a n d m a k e t h e f i 1 e J u s t 
long enough to hold the interval* In this case a messages IF FILE 
of the form* TOO 

SHORT 
COMPACTING ON DRIVE (drive designator) DISK 

WILL BE 
w i 1 1 b e p r i n t e d w h i I e t h e e o m p a c t i n g i s g o in <$ a n ♦ I n C M - 
t h i s w a y D I S K A T E h a n d 1 © s a 1 1 d i s k s p a c © a 1 1 o c a t i o n f o r P A C T E D 
y (^ u y a n d y o u n © © d n ' t b © c o n c © r n © d a b o u t a 1 1 o o a t i n g 
1 © n g t h s f o r f i I © s ♦ Of c o u r s © y t h © s i t u a t i o n c a n a I w a y s 
arise that you run out of space on a diskette* In this 
case D I SKATE will print an error messag© to this effect 
o n t h e t e r m i n a I * 1 1 c a n a 1 so h a p p e n t h a t t h e d i r e a t o r v* 
b © c o m e s f u 1 1 i f t h e r © ar © 6 A f i I & s o n t h © d i s k © 1 1 © ♦ A n 
S c o m m a n d for a n © w f i I © w i 1 1 a 1 s o c a u s © a n © r r o r i n 
t h :i. s s i t u a t i o n ♦ T h © © r r o r m © is s a g © s w i 1 1 t © 1 1 w o •..! t h a t 
e i t h e r t h e d i s l<. o r t h e d i r e c t o r w i s t o o f u 1 1 y a i "i d w i 1 1 
tell you which drive* A similar error m©ssag© will b© 
printed in cas© of hard disk errors* 

B © c a u s © D I S K A T E w i 1 1 a u t o m a t i c a 1 1 « c o m p a c t t h © d i s k 
if an ©listing file is too shorty if you have a DOS or NO OVER™ 
other Piece of software that can directly manipulate the LAPPING 
di rectory y you MUST NEVER CREATE OVERLAPPING PILES as PILES 
the D I SKATE compact in. g routine will not work if files ALLOWED! 
overlap* Of course y if all of the files on a diskette 
w © r © o r © a ted u s i n g D I S K A T E y t h i s w i 1 1 b © n o pro b I © m * 

Any interval can b© given as the second argument of 
an S command* The general form of the S command is* 

S f i I © n a m © i n t er^/B 1 

Her© the interval MUST be given you can't use the de- 
fault argument for the disk commands y to prevent errors* 
Using Bn S command for an interval smaller than the 
whole file gives a simple way to BREAK UP A PILE INTO 
SMALLER PARTS* Editing a file in parts has some advan- 
tages* There is less chance that you will run out of 
room in the memory Just at a time when you don't want 
such considerations to disrupt your train of thought in 
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editing the text* and D I SKATE will run faster with 
smaller files* Suppose you have a file called SPECS* 
for instance* and you want to break it into 2 parts* the 
first part being the first 147 lines and the second part 
being the rest* Let's call the two parts SPECS and 
SPECS'* (Note that ' is a valid symbol to be part of a 
f i 1 e name*) U e ' 1 1 a 1 s o a s s u m e t h a t t h e w h o 1 e t h i n g i s 
in the memory as the current file* To break it up into 
t w o p i e c e s y o u c a n u s e t h e c o m m a n d s * 



S SPECS * ♦ 147! 
S SPECS' 148! ♦ * 

I 

( I n t h i s c a s e w e ' r e a s s u m i n g t h a t t h e R E F c o m m a n d i s n o t C (!) M M A N D 
b e i n g u s e d ♦ ) No t e t h a t a f t e r t h e s e c o m m a n d s * ■ u s e d a s 

a file name will denote SPECS'* You can also save LISTS 

i. n t e r v a 1 s f r o m o u t s i d e t h e s o u r c e ar^a* We' 1 1 s e e s o m e F I L E S 

examples of this below* ON DISK 

To examine what is on a disk you can give the 1 DRIVE 

command -- I for Identify* The I command with no argu- GIVEN AS 

m e n t w i 1 1 1 i s t t h e f i I e s o n t h e c u r r e n t d r i v e * I f y o u A R U M E N T 
want the files on a specific drive listed* the drive 

designator can be given as an argument* For Bach file WITH NO 

the listing will tell you the length of the file* ARGUMENT 

w h e t h e r i t i s a s o u rc& f i I e or n o t * a n d i f n o t w i 1 1 g :i. v e L I S T S 

the memory address* The listing will also print the CURRENT 

n u m b e r of bloc k s o f f r e e s p a c e o n t h e d i s k * a s w e 1 1 a s D R I V E 
the number of remaining directory entries* The address 
of the file on the disk is not included in the listing 

from an I command* since you don't have to worry about FS 

specif i c d i s k a d d r e s s e s ♦ H o w e v e r * i f w o u n e e d a 1 1 t h e C M M A N D 
information that exists in the directory* DISK ATE keeps 

a c o p y o f t h e e n t i r e d i rector y i n t h e m e m o r y * a n d we' 1 1 P R I N T S 

see in Part II how you can access this if you neBd to* AMOUNT 

If you are using many S commands without using the file OF FREE 

name " » g i v i n g t he I c o m m a n d p&r i o d i c a 1 1 w i s a go o d i d e a S P A C E N 

to make sure there are no extraneous files on the disk DRIVE 
resulting from an erroneous S command* 

You may want to know only how much space is left on SAME ARG 

a disk* without needing a complete listing of all of the CONVEN™ 

f i I e s ♦ T h 1 s c an be o b t a i n e d w i t h t h e F S c o m m a n d * F S f or T 1 N A S 

Free Space* The argument for this command works the I 

same as for the I command* either a disk drive design a- COMMAND 
tor* or no argument indicating the current dri^/B* 

Of course there has to be a way to delete a file* 

and this is accomplished with the U command* U for Un~ U 

save* The U command takes a file name as its argument* COMMAND 
and deletes the file from the disk* Of course* the file 

name can include a disk drive designator* DELETES 

At this point we come to another important command* FILE 

the command for loading a file* Although it might seem FROM 

straightforward* there arts several ways that trouble can DISK 
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o c c u r :i. f n o t u s e d care f u 1 1 y ♦ T h e L c o m m a n d ? I... f o r L o a d ? 
will load the file given as the first argument into the 
memory* The memory address where it is loaded can 
either be given as the second argument ? or omitted? in 
which case D I SKATE will determine the load address in 
t h e f o 1 1 o w i n g w a y ♦ If t h e f i I e i s n o t a s o u r c e f i I e 
then it is loaded at the memory address given by the 
memory address portion of the directory entry for the 
file* If the file was saved by D I SKATE then this 
a d d r e s s w i 1 1 b e t h e a d d r e s s i n m e m o r y w h e r e t h e f i 1 e 
began at the time it was saved* If the file was created 
b y a n o t h e r p :i. e o e o f s o f t w a r e ? y o u s h o u I d a 1 w a y s g i v e t h e 
load address as a second argument to the I. command 
unless the file is of type 0* Otherwise there may be no 
t e 1 1 i n g w h a t is w r i 1 1 1 e n i n t h e s p a c e i n t h e d i r e e t o r y 
w h e r e D I S K A T E e x p e c t s t h e m e m o r y a d d r e s s ♦ Y o u w i 1 1 g e t 
«uite a surprise if you give an I... command without a load 
a d d r e s s a n d t h e f i 1 e c I o b b e r s p a r t o f t h e r e s i d e n t 
software* 

If the file to be loaded is a source file and the 
load address is not given as a second argument? then it 
i s I N S E R TED i n t o t h e c u vvb n t f :i. I e b e t w e e n t h e t a r g e t 
c h a r a c t e r a n d t h e p r e c e d i n g c h a r a c t e r — i ♦ e ♦ e x c a 1 1 y 
where text is inserted by an E or M command* The target 
o h a r a c t e r w i 1 1 t h e n be s e t t o t h e f i r s t c h a r a o t e r a f t e r 
the t e x t I o a d e d f r o m t h e d :i. s k f i I e * T h e r e are t w o 
i m p o r t a n t c o n s i d e r a t i o n s h e r e ♦ E i r s t ? :i. f t h e t a r g e t 
o h a r'a c t e r h a p p e n s t o b e o u t s i d e t h e s o u r e e a r e a ? t h e n 
the file will be loaded at the location divert by the 
entry pointer OVERWRITING WHATEVER IS THERE* The source 
area remains unchanged* Because an I... command can affect 
a very Iar«*e number of bytes? an error of this kind can 
be catastrophic* If you have been using D I SKATE as a 
monitor to work with memory outside the source area? 
t h e n g :i. v e a n L c o m m a n d w i t h n o s e c o n d a r g u m e n t f o r a 
source file but have forgotten to restore the entry 
pointer? this could overlay a substantial portion of the 
memory and possibly clobber part of the resident soft- 
ware resulting in a crash* Second? even if the entry 
pointer is in the proper place? if the file is a long 
o n e i t w i 1 1 e x p a n d t he so u r c e a r e a c o n s i d e r a b I w ♦ Y o u 
should always check to make sure that the expanded 
source area will still fit in the area of your memory 
that is safe for the source area to occupy* If you 
w a n t t o w o r k w i t h o n I y a s i n g 1 e s o u r c e f i I e a 1 1 b y 
itself? it's always good practise to <:iive an command 
w :i. t h no a r g u m e n t f i r s t ♦ T h a t way y o u h a v e a n e m p t y 
source area to work with* 

Obviously you can use the I... command to load into 
m e m o r y a f i I e w h :i. c h w a s p r e v i o u s 1 y s a v e d ♦ B u t t h e r e a r e 
also some powerful uses for the L command in addition to 
this* We recall that a K command followed by an E eom™ 



COMMAND 

LOADS 
FILE 

GIVEN AS 
1ST ARGU- 
MENT TO 
MEMORY 
LOCATION 
GIVEN AS 
2ND ARG 

IE NO 
2ND ARG 
GIVEN? 
USES 
MEMORY 
ADDRESS 
FROM 
DIREC- 
TORY IF 
NOT 
SOURCE? 

INSERTS 

AT 

TARGET 

CHAR IF 

SOURCE 

AND ~ 

WITHIN 

SOURCE 

AREA* 

ELSE 
OVER- 
WRITES 

AT ~ 



GIVE 
COMMAND 
BEFORE 
I... TO 
WORK 
WITH 
ONLY 
ONE FILE 
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m 3 n d w i I 1 r e p 1 a c e t h © d e 1 e t e d t e x t, ta y t h e t e x t e n t e r e d 
with the E command* A K command followed by an I... com- 
m a n d w h :i. c h ti i v e s a s o u r c e f i 1 e a s t h e f :i. r s t a r <3 u m e n t a n d 
has no second argument will REPLACE THE DELETED TEXT BY 
THE LOADED FILE** In this way it is possible* for 
instance* to maintain a library on the disk of standard 
paragraphs* use an abbreviation to denote the paragraphs 
i n e d i t i n «* a n d t h en w r i t e a m a cro w h i c h w i 1 1 s u b s t :i. t u t e 
d i r (••:• c 1 1 w f r o m d i s k t he parativ a p h f o r t h e a b b r e v i a t i o n * 
This can be used to write form letters* Just to cite one 
sppIi cation* 

Another important way the I... command can be used is 
t o c o n c a t e n a t e o r c o m b i n e f :i. 1 e s * S u p p o s e w e # o b a c k t o 
the e x a m p 1 e a hove w h ere a f i 1 e S P F S w a s s p 1 i t i n t o t. w o 
f :i. I e s * S P E S a n d S P E C S ' * S u p p o s e t h a t a f t e r f u r t h e r 
e d i t i n «•* t h e v e r b o s i t y i s r e d u c e d a n d t h e t w o f i I e a r e 
n o w s m a 1 1 e n o u <$ h t h a t i t w o u 1 d b e m o r e c o n v e n i e n t t o 
h a v e t h e m c o m b i n e d i n t o a s i n «* I e f i 1 e * B e c a u s e t h e t w o 
f i I e s w e r e s a v e d f r o m t h e s o u r c e a r e a t h e y a r e b o t h * 
source files* The Job we want to do can be done by the I... filet* 
f o 1 1 o w i n «l c o m m a n d s * L f :i 1 e 2 

0*1 WITH 

I... SPECS * L SPECS ' * " * * filet* 

U SPECS' *S SPECS ** fil©2 

SOURCE 

The command will collapse the source area so that the FILES 
c o m b i n e d f i 1 e w i 1 1 n o t p i c k i. j p a n y e x t r a n e o u s i n f o r m a - 

t i o n ♦ The I c o m m a n d i s $ i v e n s o t h a t w e c a n v e r i f y t h a t W 1 1... I... 

t h ere w i 1 1 ta e e n o u <•* h r o o m i n t h e m e m o r y t o h o 1 d t h e c o m - M B I N E 

b :i. n e d f i 1 e ♦ Note t h a t t h e c o m m a n d w i 1 1 p u t t h e e n t r y T H E 

pointer at the end of the empty current file* which will FILES 

b e t h e o n I y f i I e i n t h e s o u r c e area* A f t e r L S P E C S * t h e INTO 

entry pointer will be at the ^nd of the material loaded* ONE 

so we can «Jo ahead and <3ive the second L command* "♦* FILE 

is <3iv®n to make sure the file looks correct before we AS THE 

«to ahead and make any changes on the disk* Now that we CURRENT 

know that the file is correct in the memory* we FIRST FILE IN 

d e I e t e S PECS'* T h a t w a y t h ere w i 1 1 b e n o d o u b t t h a t h E M R Y 
t h e r e w i 1 1 b e r o o m o n t h e d i s k f o r t h e c o m b :i. i"i e d f i 1 e * 
The S command will save the file and JusfsEle the position 
of the files on the disk if necessary to make room for 
it* 

S i..i p p o s e y o u a r e w o r k i n «{ w i t h s o u r c e f i 1 e <•> i n t h i. s 
way and sJive an L command* but by mistake specify the 

wronsi file* so that you want to delete that part of the <R> 
o u rre n t f i 1 e i n the so u r c e a r e a t h a t y o u J u s t I o a d e d ♦ 

f c o «..« r s e * y o u c o u 1 d b a c k t r a c k * se i v e a n o o m m a n d a n d G I U E S 

s e t i.j p t h e c u r r e n t f i I e a 1 1 over a «* a i n u p t o t h e p o i n t I N T E R U A L 

you slave the load command* but this is a lot of work* OCCUPIED 

and anyway you may not be able to reconstruct how it was BY LAST 

d o n e ♦ D I S K A T E h a s a s p e c i a 1 s y m b o I w h i c h w i 1 1 h e I p i n R E C R D 
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this case* <R> is a symbol analogous to <S> and denotes LOADED 

FROM 
DISK 



the INTERVAL IN MEMORY OCCUPIED BY THE LAST RECORD CUE, 
FILE) READ IN FROM DISK* If aou are combining source 
f :i. 1 e s b y t h e t e c h n i « u e a b o v e a n d r e a 1 i z e t h a t t h e 1 a s t L 
command given was in error? that part of the current 
file that was put there by the last I... command can be 
deleted by the command* 

l«R> 

B e c a u s e t h e K e o m iri a n d w :i, 1 1 p o s :i. t :i, a n t h e e n t r y p o i n t e r t o 
t h e e n d o f t h e d e I e t e d m a t e r :i. a I * y o u e a n :i. m m e d :i. a t e 1 y 
follow it with the correct L command y and the mistake 
w :i. 1 1 b e e o r r e o t e d ♦ 

There are several disk commands which can be used 
t o c o p y i n f o r m a t i o n o r c h a n g e t h e s t a t u s o f f i I e s * I f 
you want to CHANGE THE CURRENT DRIVE* the command CD* 
which takes as its argument a disk drive designator* 
w i 1 1 e s t a b 1 i s h t h e d r i v e i n d i c a t e d b y t h e a r g u m e n t a s 
t h e o u r r e n t d r i v e ♦ I* n P a r t 1 1 w e w i 1 1 s e e h o w t o 
customize your system so that D I SKATE knows which drive 
d e s i g n a t o r s a r e v a 1 i d * 1 1 i s :i. m p o r t a n t t h a t t h i s b e 
d o n e o o r r e c 1 1 y y o r e 1 s e a D c o m m a n d t o a n o n - e x i s t e n t 
d r i v e w i 1 1 c a u s e v e r y b a d m i s c h i e f * I f y o u h a v e 
f o 1 1 o w e d t h e e u s t o in :i. z a t i o n p r o c e d u r e o u 1 1 :i. n e d i i"i P a r t 
1 1 y y o u w i 1 1 n o t h a v e p r o b I e in s * b u t h e r e i s w h a t w i 1 1 
har'p^n if you give a CD command by mistake for a non- 
e x i s ' t, e n t d r i v e ♦ D I S K A T E w i 1 1 g o a h e a d a n d r e g i s t e r t h e 
drive as the current drive without giving an error 
message* but after that* EVERY SINGLE DISK COMMAND FOR 
THE CURRENT DRIVE WILL GIVE A DISK ERROR* You will know 
what has happened* since the disk error messages print 
the drive designator for the drive that caused the 
e r r o r * a n d t h i s w i 1 1 s h o w a d r i v e t h a t y o u d o n " t h a v e ♦ 

You can RENAME a file with the RN command* in the 
form* 



l«R> 
DELETES 
I. AST 
TEXT 
LOADED 



CD 
COMMAND 

TAKES 
DISK 
DRIVE 
DESIG- 
NATOR 
AS ARG 
& MAKES 
IT 
CURRENT 



RN 
COMMAND 



RN oldname newname 

be sure to remember to separate the two file names by a 
b I a n k ♦ f c o u r s e i n vena m i n g a f i I e * t h e f i 1 e d o e s n o t 
e h a n g e i t s 1 o c a t i o n o n t h e d i s k * s o t h a t a d i s k d r :i. v e 
d e s i g n a t o r i n n © w n a m e i s s u p e r f I i.i o u s ♦ I f o n e i s p r e «; e n t 
it is ijilnored* even if it incorrectly specifies a drive 
other than the one the file oldname resides on* 

It frequently happens that you want to copy the 
c o n t e n t s o f a f i I e f r o m o n e f i 1 e t o a n o t h e r * T h i s i s 
done with the D I SKATE T command* T for Transfer* The T 
command has the form* 

T o 1 d f i I e n e w f i 1 e 



RENAMES 
FIRST 
FILE 
AS 2ND 



T 

COMMAND 

COPIES 

FIRST 

FILE 
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In this case drive designators bv® significant* since TO 2ND 

the file to which you want the information copied could FILE 

be on another drive from the file which is to be copied* 

T h e D I R E C T R Y A T T R I B U T E S — i ♦ e ♦ size* f i 1 e t y p e y a n d 

memory address are also copied* The T command works 

a n a I o g o u s 1 y t o t h e S o o m m a n d i n t h a t i f n e w f i 1 e d o e s n o t 

e x i s t i t is or e a t e d * 

A n e n t i r e d i s k worth o f i n f o r m a t i o n c a n ta e c o p i e d T D 
at once with the TD command y which stands for Transfer COMMAND 
D :i s k * T h e T D c o m m a n d h a s t h e f o r m t 

COPIES 

TD olddrive newdrive ALL. 

FTI.ES 

w Li e r e b o t h o 1 d d r i v e a n d n e w d r i v e a r e d r :i. v e d e i s g n a t o r s * N :l S T 

The TD command is more flexible than the usual copy disk DRIVE 

c o m m a n d f o u n d i n f 1 o p p y d :i. s k o p e r a t :i. n g s w s t e m s * Li s u a 1 1 y T 2 N D 

such a command will copy the old disk onto the new disk DRIVE 

sector for sector y completely overwriting whatever was LEAVING 

on the new disk* The DISKATE TD command WILL. COPY TO ALONE 

THE NEW DRIVE ALL FILES FROM THE OLDRIVE LEAVING ALONE FILES 

ALL FILES ON THE NEW DRIVE THAT DON'T EXIST ON THE OLD UNIQUE 

DRIVE* To be spec if icy TO 2ND 

DRIVE 
TD olddrive new drive 

is eoui valent to giving* 

T f i I e i o 1 d d r i v e f i 1 e ♦ n e w d r i v e 

f o r every f i 1 e o n o 1 d d r i v e ♦ T h u s i f a f i I e f r o m 
olddrive does not exist on newdrive it is created * If 
i t d o e s e x i s t t h e c o n t e n t s f r o m t h e f :i. I e o n o 1 d r i v e a r e 
copied into it* 

Of course? it is possible that if there is already 
considerable information on newdrive that DISKATE will 
run out of room before the TD command is finished* If 
t h i s h a p p e n s y a m e s s a g e i n f o r m i n g y o u o f t h i s f a c t w i 1 1 
b e p r i n t e d ♦ I n t h i s c a s e n o t a 1 1 o f t h e f :i. 1 e s f r o m 
o I d d rive w i 1 1 h a v e b e e n t r an s f e r r e d ♦ H o w e v e r y t h e r e 
w i 1 1 b e n o f i 1 e s w h i c h w e r e o n I y p a r t i a 1 1 « t r a n s f e r r e d * 
DISKATE will check BEFORE copying the file to see if 
there is roomy and if not the TD command will terminate* 
When this happens you may want to give the command I W 
newdrive to see what files exist on this driv<r> that COMMAND 
w e r e n ' t o n o 1 d d r i v e y a n d d e I e t e s o m e o f t h e in w i t h a LI 
command to make more room* WRITES 

The memory address portion of the directory for a VALUE OF 
file can be set to a given address by using the W com- 2ND ARG 
mandy which stands for Write address* The W command has IN 
the form? MEMORY 

ADDRESS 
W f i 1 e n a m e a r g u m e n t P A R T F 
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where the argument is the same kind of D I SKATE argument 
that would be recognized taw the editing and monitor com- 
mands* The only thing that is changed taw the W command 
i s t h e m e m o r w a d d r e s s ♦ T h i s i s e s p e c i a 1 1 y u s e f u .1. i n 
connection with the assemtalery where during assemtal w the 
object code is placed one place in the memory but when 
executed the code is to be loaded at another place* 
w" e ' 1 1 1 o o k at t h i s i n ir< o r e d e t a 1 1 i n t h e n e x t s e e t i o n * 

We conclude this section with a command which is 
extreme 1m convenient but which v^an also cause serious 
grief if used incautiously* The GO command!* which takes 
o n 1 w a f i 1 e n a m e a s i t s a r g u m e n t y w i 1 1 1 o a d a f i 1 e f r o m 
d i s k a n d t h e n a u t o m a t i c a 1 1 w e x e c u t e i t ♦ 1 f t h e f i 1 e i s 
a s o u r c e f i 1 e y t h e n J 

GO file 

i s e e i..i i v a 1 e n t t o t 

L fileyD<R> 

w h e r e a s i f t h e f i 1 e i s N T a s o u r e e f i 1 e y t h e n G f :i. 1 e 
i s e « u i v a 1 e n t t o ♦ 

L f:i.IeyX<R> 

T h e s a m e c a 1. 1 1 i o n s t h a t a p p 1 i. e d t o t h e I... o o m m a n d a p p 1 w 
h e r e y ta u t i n a d d i t i o n y o u w i 1 1 h a v e 1 o t s o f t r o u b 1 e i f 
t h e f i 1 e t y p e h a s s o m e h o w bee o m e i i"i o o r r e c t ♦ I f w o u a r e 
processing a source file with other software which 
reeui res it to be of a non-0 twpey and then forget to 
retype it as 0? a GG command to that file will cause 
D 1' S K A T E t o c a 1 1 i t a s a in a c h i n e 1 a n g u a g e s u b r o u t :i. n e y 
which will almost certainly result in a crash* Note 
that Just as with the I... command y you must be careful to 
make sure that " is in the right placer or you can 
clobber part of the memory with a GO command to a source 
f i 1 e * 1 f t h e f i 1 e i s a n e d i t m a c r o t o b e u s e d t o w o r k 
on the current file* SAFE PROCDURE IS TO GIVE AN N 
COMMAND BEFORE THE GO COMMAND* Note that in this case 
t h e m aero w i 1 1 h a v e t o r e s t a b 1 i s h t h e f i 1 e t h a t w a s 
c u r r e fi t ta e f o r e t h e N c o m m a n d a s t h e c u r r e i "i t f :i. 1 e * 



DIREC- 
TORY FOR 
FILE 

GIVEN AS 
1ST. ARG 



GO 
COMMAND 

LOADS 

FILE 

AND 

EXECUTES 

IT 

EQUIVA- 
LENT TO 
I. % D 
COMMANDS 
FOR 

SOURCE 
FILESv 
I % X 
FOR 
NON- 
SOURCE 
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I ♦ 4 U s i n g D I S K A T E a s a n A s s e m b I e r 



S p a o e w i 1 1. n o t p e r in :i. t t h :i. s t o h e a g e n e r a 1 t e x t b o o k 
on 8080 assembler programming* It will be assumed that 
y o u a r e a t 1 e a s t r o u g h 1 y f a m :i. 1 :i. a r w :i. t h w h a t a n a s s e m b 1 e r 
is all about? ®nd that you've had some exposure to the 
8080 instruction set* The D I SKATE assembler operates in 
TWO PASSES* In Pass 1 * the assembler does not create 
»nw object code* Rather 9 it goes through the source 
code keeping track of where each symbol is defined* Tn 
t h e p r o o e s s i t c o m p i I e s a S Y M B L T A B I... E ♦ T h e s y in b o I 
table is a string of items containing the symbol and 
t h e n a 1 6 b i t n u m b e r g i v i n g t h e v a 1 1. 1 e o f t h a t s y m b o 1 ♦ 
At the end of the table is a 0* The symbol itself is 
recorded in the following format* There is no field for 
t h e I e n g t h o f a s y m b o I * I n s t e a d t h e c h a r a c t e r s o f t h e 
s y m b o I o e e u r u n t i I t h e 1 a s t c h a r a c t e r ? w h i c h h a s t h e 
h :i. si h •- o r d e r b i t s e t ♦ T h u s t h e s y m b o I A B w o u 1 d b e g i v e n 
the hex value -4:1 C2* In hex normally the character A 
h a s t h e v a I u e 4 1. » a n d B h a s t hi e v a I u e 4 2 * Setting t h e 
high-order bit for the B gives the value C2» The symbol 
t a b 1 e w i 1 1 a I s o c o n t a i n a n e n t r y f o r e v e y^ y D I S K A T E 
v a r :i. a b I e w h i c h h a s b e e n g i v e n a v a I u e ♦ T h e r e i s n o 
distinction made between a variable given a value with 
an ••■■■• command and a variable given a value by Pass 1 of 
t h e a s s e m b I e r ♦ 

There ar-^ several commands which can be used to 
deal with the symbol table* The symbol <T>v analogous 
to <S>» is a D I SKATE symbol which can be used in an 
argument to DENOTE THE SYMBOL TABLE without any match- 
ing* I-' or instance y if you want to know where the symbol 
table is in the memory v you can viivB the command* 



ASSEM- 

BI...ER 

PASS 1. 

COMPILES 

SYMBOL 

TABLE 

SYMBOL 
TABLE 

format: 

CHARS OF 
SYMBOL, v 
LAST 

CHAR HAS 
HIGH- 
ORDER 
BIT SET* 
THEN 
16-BIT 
MALUE OF 
SYMBOL 

INCLUDES 
VARIA- 
BLES 



<T> 



?<T> DENOTES 

SYMBOL 

.Just as the symbol S" denotes the address of the first TABLE 
byte beyond the source a rear T" v is a no n -matching symbol 

w h i c h d e n o t e s t h e f i r s t b w t e b e y o i "i d t h e s y m b o 1 t a b 1 e * T '"' 
This symbol can be useful in commands which serve to 

a 1 1 o c a t e m e m o r y * We" 1 1 s e e a n e x a m p 1 e o f h o w t h i s c a n D E N T E S 

b e u s e d b e 1 o w * 1 S T B Y T l-l 

It is the user's responsibility in D I SKATE to see BEYOND 

that the symbol table is not overlaid Bnd is located <T> 
within the memory so that there will be enough space for 
it* THE MOST COMMON SOURCE OF MYSTERIOUS ERRORS USING 

THE ASSEMBLER COMES FROM A FAILURE TO MAINTAIN THE UNUSUAL 

INTEGRITY OF THE SYMBOL TABLE* For instance J you can ASSEM- 

be making ar\ assembly listing and everything is going BLER 

n o r m a 1 1 y y w h e n a 1 1 o f a s u d d e n e v e r y s y m b o I i s f I a g g e d E R R S 
as not having been defined? when you can see their 

d e f i n i t i o n r i g h t i n f r o n t o f w o u r e y e s * W h a t w i 1 1 h a v e C H E C K 
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happened in this case is that <T> is located at the top 
of RAM and has overflowed off the top* No matter where 
y o u h a v e t h e s w m ta o 1 t a b 1 e i n t h e m e m o rwy w h e n a s s e m b 1 i n si 
a 1 a r 3 e p r o s* r a m f o r t h e f i r s t t i m e i t i s a s* o o d i d e a t o 
h a v e a ? < T > y o r p e r h a p s s ever a 1 y i n t h e m i d d 1 e o f t h e 
assemble so yoy can keep track of how larse <T> is 
stettins*y to make sure it won't overflow the area it is 
safe for it to occupy* 

E v e r y s y m b o 1 w i 1 1 b e r e t a :i. n e d i n t h e s y m b o 1 t a b 1 e 
i. in til a command is <3iven to remove it* The Z command y 
'«* i v e i"! w i t h n o a r s* u m e n t y w i 1 I. Z e r o - ••■• i ♦ e ♦ r e in o v e f r o m 
t h e s y m b o 1 t a ta 1 e ••- •••• a 1 1 s y m ta o 1 s e x c e p t t h o s e s y m ta o 1 s 
t h a t a r e a 1 w a y s i n i t i a 1 1 y p r e s e n t i n t h e s y m b o 1 t able o n 
p o w e y u p * As m e n t i o n e d i n I ♦ 1 » t h e s e a y* e ♦ 

Av By C» Dy Ey H» L y My SPy PSU 

If you assemble a program v see some mi stakes y then as- 
semble it 3 st 3 in without bavins* zeroed the symbol tab ley 
y o i.j w i 1 1 s* e t a n e n o r m o u s n u iyi ta e r o f a s s e m ta 1 e r e r v o y v s f o r 
h a v i n «* d e f i n e d s y m ta o I s t w :i. c e ♦ I f y o u h a v e s y m ta o I s o f 
your own that you want to keep in the symtaol tataley such 
as the addresses of mac rosy for instance y you can use 
the Z> command* This command takes a symbol from the 
s y m ta o 1 t a ta I e a s i t s a r s* u m e n t y a n d w i 1 1 Z E R A I... I... S Y M B L B 
DEFINED SUBSEQUENTLY TO THE ARGUMENT SYMBOL* 

S u p p o s e for i n s t a n c e y o u h a v e d e f i i "i e d a 1 1 o f t h e 
symbols that you will be want ins* to keep* You can slive 
the command* 

KEEP=0 



:t> 



Z 
COMMAND 

NO ARG 

ZEROS 

SYMBOL 

TABLE 

EXCEPT 

FOR 

INITIAL 

SYMBOLS 



Z>symboI 
COMMAND 

ZEROS 

ALL 

SYMBOLS 

DEFINED 

AFTER 

symtaol 



to define the variable KEEP as a marker for those va ria- 
ls 1 e s t h a t w i 1 1 n e e d t o ta e z e y* o e d f o r e a c h a s s e m ta I y * 
Ttaeny to zero all of the symtaol s except those you want 
to keep you can s*ive the command? 



Z>KEEP 

Y o u o a n a I s o z e r o a s p e e i f i c :i. n d i v i d u a I s y m ta o I * 
This is done by slivins* the Z command with the symbol as 
a n a r s* u m e n t ♦ T h e s y m ta o 1 w i 1 1 ta e y % e m o v e d f r o m t h e s w m ta o 
t a ta 1 e a n d t h e s « m ta o 1 t a ta I e w i 1 1 ta e c o m p a c t e d :i. f t h e s y m 
bo I zeroed was not the last symbol in the table* Note 
t h a t i n «•? :i. v i n <•{ t h i s c o m m a n d y t h e r e m u s t b e N (!) B L A N K 
BETWEEN THE Z AND THE SYMBOL* If there is such a blank 
D I S K A T E w i 1 1 p e r f o r m a s t r a i st h t Z c o m m a «"i d a n d z e r o t h e 
e n t i r e s y m ta o I t a ta I e ♦ 

There ar^ several ways of m anas* ins* the symtaol tatal 
u s i n s( c o m m a n d s w e ta a v e . a I r e a d y s e e n ♦ A ta o v e we m e n t i o n e 
that the M command will update all of the relevant DISK 
ATE pointers* This includes the pointers that define 



Z symbol 
COMMAND 

ZEROS 

ONLY 

symtaol 



M<T> 
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t h e b o u n d a r i e s of < T > ♦ I f w o u r m e m o r y i s 1 :i. m i t e d ? y 6 u C M M A N D 
maw want to allocate? only a small amount of space to <T> 

while editing? when the number of symbols in use is WILL 

small but you will ne^d a lot of space for <S>* But? RELOCATE 

as we" 1 1 s e e ? D I S K ATE can ass e m b 1 e d i r e c 1 1 y f r o m d i s k ? 8 Y M B (!) L 

so that when assembling you may not n&Bd a large source TABLE 

area but will want a large space for <T>* Thus the TO START 

a b i 1 i t y t o c h a n g e t he I o c a t i o n o f t h e s y m b o 1 t a b 1 e i n A T "' 
the memory is important* Let's say you have the symbol 
table at 1.E00H and want to move it to 2000H* This can 
be done with the command* 

'*2C00H?M<T> 

The symbol <T> can also be used with the L and S 
commands to save and restore symbol tables* This is a 
useful technique for assembling one program to go with 
another? without having to assemble the two of them 
together* For instance the command* 

S TBLSAVE <T> 



w i 1 1 s a v e t h e s y m b o 1 t a b 1 e i n a f i 1 e e a 1 1 e d T B L 8 A V E ♦ 
Now suppose you want to restore the symbol table to the 
way it was Just before you saved TBI... SAVE* There av^ two 
t h i n g s t h a t h a v e to b e d o n e * F i r s t w e g i v e t h e c o m m a n d i 



f i lename 
<T> 



L TBLSAVE <T> WILL 

OVER™ 

T h i s w i 1 1 U E R W R I T E t h e c u rr-e n t s y m b o 1 t a b 1 e w i t h i h e W R 1 T E 

contents of the file TBI... SAVE* Now there is one problem* <T> 
B 1 8 K A T E w i 1 1 s t i 1 1 h a v e t h e o I d v a 1 u e s t o r e d i n t e r n a 1 1 y 

f o r t h e u p per b o u n d o f t h e s « mb o I t a b 1 e ♦ 1 1 i s u n I i k e I y T 8 E T 

that this will be the same as the upper bound for the UPPER 

table saved in TBI... 8 AVE* To set the upper bound of a BOUND 

symbol table Just r&ad in from disk? the easiest method SET 

is to SET A VARIABLE NOT IN THE SYMBOL TABLE EQUAL TO 0* UNUSED 

So? if we can be sure the variable JUNK was not in the VARIABLE 

s y m b o 1 t a b 1 e s a v e d i n T B L S AVE? t h e c o m m and* ■ = ' 

JUNK*0 



w:i. 
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ablish the upper bound of the symbol table* The 
his works is that when an - command is given? 
searches through <T> from the beg i nn in <•$ for the 
and w h en i t f i n d s i t a s s i g n s i t t h e v a 1 u e ♦ 1 1 
the symbol if it reaches the Bnd of <T> before 
it* But? in defining a new symbol? the size of 
ol table increases? so a new upper bound for <T> 
r e c o r d e d ♦ T h i s i s why a n »- com m a n d t o a n o n - 
i a b I e w i 1 1 s e t t h e u p p e r b o u n d ♦ T h i s tech n i e » ..i e 
the cornerstone of the process of customizing 
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B I S K A T E d i s e u s s e d i i"i P a r t 1 1 ♦ 

I n iti a n y e a s e s y o u m a w f i i"i d t h a t c o m m a n d s w :i. 1 1 w o r k 
p T * c) p e r 1 y :i. f y o u g i v e o n 1 y a n I... f :i. 1 e n a m e < T > c o m m a n d 
without setting a dummy variable = 0* For instance)' wou 
could j^ive a command* 

I... TBLSAVE <T> 

and then a command Tsymbol where symbol is one of the 
s y in b o X s :i. n T B I... S A V E ? a n d e v e n t h o u g h D 1 8 K A T E w :i. X X n a t 
have recorded internally the proper upper bound for the* 
s y m b o X t a b X e T B I... S A v" E y t h e ? c o m m a n d w i I X w o y* k p r o p e r X w 
a n y w a y * T h :i. s :i. s b e o a u s e t h e ? c o m m a n d w :i. X X s o a n t h r o 1. 1 g h 
<T> taking the at the ^nd as its indication of the ^nd 
of the table y rather than consulting the pointer giving 
the upper bound* However v if you have not set the value 
o f a d u m m y v a r i a b X e a n d t h e n g i v e t h e c o m m a n d ? < T > y a n 
i n c o r r e c t v a X u e w i X X b e p r i n t e d f o r t h e i. j p p e r b o i .» n d o f 
<T>* Under these circumstances if you move <T> with the 
M c o iti m a n d y y o u m a y v e r y w e X X e n d u p m o v i i "i g o n X y a s m a X "I 
p a r t o f i t a n d X o s i n g m o s t o f y o u r s y m b o X s ♦ I n a X X o f 
our examples in this manuaX we have gone to the extra 
troubXe to set the dummy variabXe Just to be safe* 

Now that we've thoroughly discussed the symbol 
table* we can get on to describing how the assembler 
w o r k s * A c o m p I e t e u n d e r s t a n d i n g o f < T > :i. s c r u c :i, a I. y 
because as mentioned above* not properly manssfinsi <T> is 
t h e g r e a t est s o u r c e o f p e c u X i a r a s s e m b X e r e r r o r s * 

Assembler language statements ave divided into two 
types J PSEUDO operations and MACHINE INSTRUCTIONS* The 
machine instructions ar^> each coded into a single 
m a c h i h e 1 a n si u a g e i n s t y* u c t i o n o f o b ». i e e t e o d e y w h e r e a s t h e 
pseudo ops are directives to the assembler itseXf* 
There are four fields to every assembler statement y some 
of which may be empty* 

1. * The label field 

2* The opcode field 

3* The operand field 

4* The comment fieXd 



The DX SKATE assembXer aXXows you to use TWO DIFFERENT 
formats for specifying these fields* In the PROCESSOR 
TECHNOLOGY FORMAT? 

a* The label field begins in the first character of 

each line* If an assembler statement is not to be 
given a label y the first character of the line must 
be blank* The label is given without any symbol to 

terminate it* A label must contain only uppot ease 

letters or digits and must begin with a letter* 



PROCES- 
SOR 
TECH- 
NOLOGY 
FORMAT 
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b» The opcode field is separated from the label field 
by one or more blanks* 

o* If the statement takes an operand* the operand field 
is separated from the opcode field by one or more 
blanks 

d* The comment field is separated from the previous 
field by one or more blanks* 

e * T h e e n t i r e I i n e c a n b e d e s i g n a t e d a s a o o m m e n t b y I N T E I... 
g i v i n g * a s t h e f i r s t c h a r a c t e r o n t h e I i n e ♦ F R M A T 



T h e I N T E L f o r m a t d i f f e r s f r o m t h :i. s i n t h e f o 1 1 o w i n si 
respects* 

a * A I a b e 1 i s t e r m i n a t e d w i t h a c o I o n ♦ I f a s t a t e m e n t 
is not to be ^iven a label? the opcode may begin the 
1 i n e s i n c e t h e a b s e n c e o f t h e o o 1 o n f o 1 1 o w i n g o p c o d e 
designates it as the opcode field* 

b * T h e c o m m e n t f i e I d b e g i n s w i t h a s e m i c o I on ("*")* 

In both formats the mnemonics for the machine instruc- 
tion opcodes ar^ the same? which ar& referred to as 
INTEL MNEMONICS* 

n p o w e r - u p * D I S K A T E w i 1 1 r e c o g n i z e t h e P r o c e s s o r 
Technology format unless you have customized your system 
so that it comes up recognizinsi the Intel format* (The 
m e t h o d for d o i n g t h i s i s d e s c r i b e d i n P a r t II*) Y o u c a n 
change the format for the assembler us ins* INTE for Intel 
form a t * a n d P R S f or P r o c e s s o r T e c h n o I o si y * T h e s e ca n 
either be given from the terminal as commands with no 
argument* or as pseudo-ops in a source program* Thus a 
program can be a mosaic of segments in both formats* 

W h e n t h e a s s e m b 1 e r b e g i n s P a s s 1 * i t w i 1 1 be go i n si 
through your source statements* counting where the bytes 
of o b J e c t c o d e w i 1 1 <$ o b u t w i t h o u t a c t u a 1 1 y p u 1 1 i n g a n y - 
thing anywhere* The assembler needs to know where the 
f i r s t m a c h i n e i n s t r u c t i o n i s t o b e 1 o c a t e d ♦ I n D I S K A T E 
this is handled by two internal 1.6 bit locations* the 
assembler PROGRAM COUNTER* which is denoted by &* ant^ 
the assembler STORAGE COUNTER which is denoted by H>* 
The program counter keeps track of the location of each 
machine instruction in terms of WHERE THE INSTRUCTION 
WILL BE IN THE MEMORY WHEN EXECUTED* The storage coun- 
ter keeps track of WHERE EACH INSTRUCTION IS STORED IN 
THE MEMORY AS THE OUTPUT OF PASS 2 OF THE ASSEMBLER* 
The storage counter is not changed during Pass 1* since 
no object code is generated during this pass* D I SKATE 
needs an initial value for the program counter* You may 
want the default value for X to be 0* but then again you 
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may not* The value of % at power- up can be set by the COUNTER 
c u s t o m i. z a t i o n p r o o e d u re d e s e r :i. b e d i n P a r t 1 1 ♦ Y o u e a n 

give it any value within the rsnae of 1.6 bits* You can LOCATION 

also set its value using the & command* This command is WHERE 

analogous to the " l command* it sets & to the value of INS.TRl.JC~ 

t h e a r g u m e n t ♦ I... i k e w i s e y the $ c o m m a n d w i 1 1 s e t t h e T I (!) N S 

storage counter to the value of its argument* When you ARE 

customize D I SKATE you must be sure that the power up STORED 

value for $ is the location of a place in memory where BY 

object code can safely go? in case you forget to set * PASS 2 
from within an assembler source program* 

Here is one way the %. and $ can be used* Suppose 
you have a machine language program which you wish to 
i. j s e i n c o n n e c t i o n w i t h e d i t i n g ? b u t y o u d o n ' t w a n t t o 

commit yourself to where in the memory it will go* Now & 

s i..i p p o s e y o u h a v e d o n e s o m e w o r k o n a s o u r c e f i 1 e » a n d M M A N D 
have decided you want this program to be brought in from 

the disk and to reside 1024 bytes past the end of the SETS & 

source area* First i-ii\/e the command* TO 



ARGUMENT 



SS~+1024»* 



then assemble the program directly from disk* We'll see * 

h o w t o d o t h i s b e 1 o w ♦ T h e m e t h o d o f n o t s p e c :i. f y i n g C M M A N D 

initial values for % and S within a source program but 

relying on U> and & commands from the terminal can be SETS $ 

i..i s e d t o g r e a t a d v a n t a g e f o r f 1 e x i b i .1 i t y a s t o w h e r e a T 

p r o g r a m w i 1 1 g o y b u t i t d o e s h a v e s o m e r :i. s k * A s s e m b 1 i n g A R G U M E N T 

the program and forgetting to give the values for % and 

$ w i 1 1. d e p o s i t t h e c o d e :i. n t h e w r o n g p 1 a c e i n m e m o r y 9 

w h i c h c o u 1 d 1 e a d t o t r o u b 1 e * A R G 

I ri in a n y o a s e s v p o s s 1 b 1 y i n m o s t e a s e s y y o u w i 1 1 P S E LI D 
w a n t t o s e t t h e i n i t :i. a 1 v a 1 u e s f o r & a n d $ f r o m w i t h i n 
the assembler source program* There ave three pseudo™ SETS % 
ops for this purpose* The pseudo™ op AORG (for Assembler TO 
Origin) will set & to the value of the operands' while OPERAND? 
S R G C f o r S t o r a <•? e r 1 5=5 i n ) w :i 1 1 s e t $ t o t h e v a 1 u e o f t h e 
operand* It is important to remember that a SORG state™ SORG 
merit DOES NOT TAKE EFFECT UNTIL PASS 2* The storage 
o o u n t e r :i; s 1 e f t c o m p 1 e t e 1 y u n t o u o h e d d u r i n g P a s s .1 * S E T S S 

Another pseudo-op that affects both & and $ is ORG* TO 
The value of separating the function of % and •$ is that OPERAND 
it allows you to assemble programs which will execute 
from a place in the memory currently occupied by some™ 
t h i n g e 1 s e i n t h e D I S K A T E e n v i r o n m e ri t * 1 n s u c h a <:? a <». e 
you want the object code to be stored in a different 
p 1 a c e f r o m t h e p 1 a e e w h e r e i t w i 1 1 g o w h e n t h e p r o g y i a m 
is run* Here you will need separate AORG and SORG 
s t a t e m e n t s * H o w e ver? i n m a n y c a s e s y o u w i 1 1 b e a b 1 e t o 
a s s e m b 1 e a p r o g r a m d i r e c 1 1 y i n t o p 1 a c e * T h i s w i 1 1 h a v e / 
t h e a d v a n t a g e t h a t y o u c a n b e g :i. n d e b u g g i n g :i. m m e d i a t e 1 y 
a f t e r a s s e m b 1 y 9 w h i 1 e t h e s y m b o 1 t a b 1 e i s s t :i. 1 1 i n t h e 
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m e m o r y ♦ I n t h :i. s t y p e o f s i t u a t i o n « o u w :i 1 1 p r o ta a b 1 y R 

want to use the ORG statement ♦ The ORG statement resets 

b o t h & a n d $ b y t he f o 1 1 o w :i. n g r u 1 e * S E T S & 

TO 

OPERAND 

It % is reset from the value it had before the ORG* AND 

w h i e h we' 1 1 c a 1 1 o 1 d & y to the v a 1 u e o f t h e o p e r a n d H A N G E S 

o f t h e ORG s t a t e m e n t y w h :i. e h we" 1 1 o a 1 1 n e w & * $ B Y 

THE SAME 

2* $ is reset to * f new 8 - old** AMOUNT 

AS & UA8 

T n o t h e r w o r d s y f i r s t % i s r e s e t t o t h e o p e r a n d o f t h e C H A N G E D 
ORG statement* and then * is reset BY THE SAME RELATIVE 
AMOUNT AS & WAS* This means that a source program only 
needs to have one instance of a separate A ORG and SORG 

a t t h e b e g i n n i n g a f t e r t h a t R G w i 1 1 m a i n t a i n t hi e 

p r o p e r o f f s e t b e t wee n & 3 n d $ t h a t w a s e s t a b 1 i s h e d w i t h 
the AORG and SORG* However y if you go on to assemble a 
new program with a different offset between the Initial 
value of % and the initial value of $y you maw have to 
f i r s t r e s e t 8 a n d $ f r o m t h e t e r m i n a 1 * 

p e r a n d s o f a s s e m b 1 e r s t a t e m e n t s c a n b e 1 a b e 1 «> y a n d 
can include arithmetic operations fy -y *y and / provi- 
ded the expression can be given a value at the time the 
assembler encounters it* You can also use DI SKATE 

swmbols such as <S>y <T>* $y &y etc * y but you can't use PSEUDO 

complex arguments involving matching of the kind we saw EQU 
i n sect i o n 1 ♦ T h e p s e u d o - o p E Q U ( f o r E Q U a t e ) c a n b e 

u s e d t o a s s i g n t he v a 1 u e o f a n e x p r e s s i o n t o a 1 a ta el* A S S I G N S 

I f a n E Q U s t a t e m e n t h a s a 1 a b e 1 y t h o u g h y t h a t 1 a b e 1 h a d I... A B E I... 

better not appear in the operand* Thusy if you had a THE 

table and wanted to set a label eoual to the length of VALUE 

the table y you could have t OF THE 

OPERAND 

TABLE * * * 

* 

* 

* 
TBLEND EQU % 

♦ 

♦ 

* 
TBLLEN EQU TBLEND-TABLE 

but you can't hav^t 

TABLE EQU TBLEND-TABLE 

Alsoy you cannot give a label a value with an EQU more 
t h a n o n c e * 1 n a n y a s s e m b 1 y y 1 a b e 1 s a r e d e f i n e d o n c e a n d 
then retain that value throughout the duration of the FOR 
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assemble process y unlike variables that maw be changed MULTIPLE 

at any time* However y you CAN attateh several labels to LABELS 

the same location in a program* For instance* if you AT ONE 

had a label called DATA to indicate the beginning of a LOCATION 

d a t a s e o t i o n y a n d T A B I... E w a s t o b e t h e f i r s t 1 a b e 1 i n G I v! E 

this section y both DATA and TABLE should label the same STATE- 

p 1. a c e * T h i s c a n b e a c c o m p 1 i s h e d b y ?3 i v i n si a n a s s e m b !l. e r M E N T S 

statement with the label DATA as THE ONLY FIELD PRESENT* WITH 

I n I n t e I f o r m a t t h i s in i g h t I o o k 1 i k e * NAM E 

FIELD 

DATA? ONLY 
TABLE? • ♦ * 

Most of the other p sen do -ops in the D I SKATE assem-- DB 

bier are standard for most assemblers* To define con™ PSEUDO 
stants you v.-: an use the pseudo-ops DBy for Define Byte* 

and DW for Define Word* DB creates a one -byte constant DEFINES 

with the value of the operand v and DW creates a 16 -bit BYTE 
constant with the value of the operand* In addition to 

numerical expressions y you can also enclose an ASCII DW 
character in single ouote marks* Thus to define a 

one-byte constant with the label STAR which is an ASCII DEFINES 

a s t e r i s k y i n I n t e I f o r m a t y o u c o u I d g i v e t h e s t a t e m e n t * W R D 

<:!./> BITS) 
STAR? DB '#' 

WITH 

Operands such as '#" can also be used with the EOU pseu- UALUE OF' 

d o a n d m a c h i n e i n s t r u e t :i. o n s * D I S K A T E w i 1 1 a 1 s o a 1 1 o w P E R A N D 
you to use multiple operands for a DB or DWy separated 

only by commas* Thus to define three consecutive bytes MULTIPLE 

of O's you could use? OPERANDS 



DB OyQyO 



ALLOWED 



To define a block of storage where you don't need DS 
to «*ive the bytes in the block an initial value you can 

u s e t h e p s e u d o D S y f o r D e f i n e S t o r a g e * 1 1 w i 1 1 a d v a n c e D E F I N E S 

%. and $ by the value of the ope randy creating the area STORAGE! 

as a block of f>ee storage* For instance* to define a BLOCK 

b 1 o c k c a 1 1 e d B U F F E R S b y t e s 1 o n g y i n P r o c e s s o r T e c h ™ W I T H 

no logy format you could use the statement* LENGTH 

GIUEN BY 

BUFFER DS 80 OPERAND 

In addition D I SKATE has a statement for defining a 

field of ASCII constants which is not standard* The PSEUDO 

pseud o ASC will define the string of bytes given by the ASC 
o p e r a nd * T h e s t r i n g i s N T d e 1 i m i t e d b « e u o t e s y b u t b y 

b I a n k s * T h e s t r i n g m a y a 1 s o b e t e r m i n a t e d b w t h e D E F I N E S 

carriage return at the Bnd of the statement line* For STRING 

instance* to define a constant which is the ASCII string* GIMEN 

"ERROR' you could use the statement* BY 
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OPERAND 

ASH ERROR 

OPERAND 

There are two special, rules to keep in mind with ABC* DELIM™ 

First* if mnemonic ASC is suffixed immediately (no I TED BY 

i n t e r v e n i n g b 1 a n k ) w i t h a n o n - a 1 p h a n u m e r i e e h a r a c t e r ? B I.. A N K S 

then ANY PLACE THAT CHARACTER APPEARS IN THE OPERAND IT 

WILL BE REPLACED BY A BLANK IN THE STRING CONSTANT 

RENE RATED* Thus the statement? ABO 

WITH x = 
ABC# A#B#C ANY NON •••• 

A I. PHANM-- 
dp fines a !=> byte constant whose value is the string* MERIC 

REPLACES 

-A B C •' WITH 

BLANK TN 
Second? the character """ (hex 5E> WILL NOT BE GENERATED STRING 
into the string constant but WILL CAUSE THE HIGH ORDER GENER-- 
BIT OF THE PREVIOUS BYTE TO BE SET* This car. be used to ATED 
define a symbol table in the same format D I SKATE uses 
for the symbol table it generates itself* For instance? " IN 
to define a short symbol table called SHORTBL with OPERAND 
entries for program labels A LHP A? BETA? and GAMMA in NOT 

Intel format you could use the statements* GENER- 

ATED? 

SHORTBL J ASC ALPHA" BETS 

DW ALPHA HIGH- 

ASC BETA" ORDER 

DW BETA BIT IN 

ASC GAMMA" PREVIOUS 

DW GAMMA KHAR 
DB 

T h e re is a s p e c i a 1 p s e u d o ? I F ? w h i c h a 1 1 o w s f o r 
conditional assembly* The form of the IE statement? not 
counting the label field? is* 

IE 

I F e x p r e s s i o n ? 1 a b e I R S E U D 

The operand thus consists of expression and label with a OPERAND 

comma between BUT NO BLANKS* (A blank would prematurely IS 

t e r m i n a t e t h e o p e r a n d f i e I d ♦ ) D I S K A T E e v a 1 u a t e s t h e E X P R E B - 

expression? and if it is not 0? the assembly continues SI ON 

as it normally would* However? IF THE EXPRESSION HAS COMMA 

THE VALUE 0? THEN THE ASSEMBLY SKIPS AHEAD TO THE LABEL 
S T A T E M E N T W I T H I... A B E L 1 a b e I ♦ Y o u c a n u s e t h i s t o h a v e 

several variants of an assembler program that share most SKIPS TO 

of their code* Note* If the expression part of the LABEL IF 

operand of an IF statement includes a variable? not yet EXPRES- 

defined? the assembler will generate an error (code A? SI ON HAS 

see below) for the statement whose label field is the VALUE 
label part of the operand of the IF statement* 
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Last? appropriately* :i.s the pseudo "OP ENDy which is 

used to terminate an assembly* The END pseudo is not END 

r e a I I y n e o e s s a r \.t v s :i. n o e t h e a t t h e e n d o f t h e I a s t P S E U D 
f i 1 e i n a n a s s e in b I. y w i 1 1 a 1 so wo r k t o t e r m i n a t e t h e 

assembly* One use for the END pseudo is if you should ENDS 

want to incorporate an assembly source program and one ASSEMBLY 

r m o r e e d i t m a c r o s i n t o t h e s a m e f i 1 e * 

Now let's focus on how to invoke and use the assem- 
bler* A strong advantage of Dl SKATE over many other A 
assemblers is that the two passes of the assembler may COMMAND 
b e i n v o k e d s e p a r a t e 1 y * T h ere a r e t h r e e p e r t :i. n e n t a s s e m •••• 
b 1 e r c o m m a n d s i n D 1 S K A T E ♦ T h e A c o m m a n d y f o r A s s e m b 1 e * I N U K E S 
will invoke both passes of the assembler y while the A:l, BOTH 
c o m m a n d w i 1 1 i n v o k e o n 1 « P a s s :l. a n d t h e A 2 w i 1 1 i n v o k e A S S E M 
only Pass 2* There are two ways for sEivinsf arguments BI...ER 
for the various A commands* IF NO ARGUMENT IS GIVEN y PASSES y 
THEN THE ARGUMENT IS THE CURRENT FILE* The command A 
a 1 1 b y i t s e 1 f w :i. 1 1 s i m p 1 y a s s e m b 1 e t h e c u r r e n t f 1 1 e ♦ n A 1. P A S S 1 
the other handy you can supply as an argument A LIST OF" ONLY? 
FILE NAMES SEPARATED BY BLANKS* When rfiven such a listy A2 PASS2 
t h e a s s e m b I e r w :i. 1 1 a s s e m b 1 e t h e p r o «* r a m 1 o <-1 i c a 1 1 y e « u i •••■ (!) N L Y 
v a I e n t t o t h e c o n o a t e n a t :i. o i "i o f t h e f i I e s <$ i v e n i n t h e 

1 i s t v t h o u sf h t h e f i I e s a r e n o t a e t u a 1 1 y c o n c a t e n a t e d ♦ N A R G 

T h e f i I e s i n the 1 i s t c a n b e p i e c e s o f o n e 1 a r <•* e p r o - U S E S < F > 
«{ r a in y o r s e p a r a t e s u b r o u t i n e s ♦ W h e n a 1 1 s t o f f :i. I e s i s 

tiivwn as the argument y the source area is left entirely ARG IS 

f r e e f o r o t h e r u s e * T h e f i I e s a r e p r o c e s s e d t h r o u «* h a I... I S T F 

special disk buffer within the Internal area occupied by FILES 

D I SKATE* (In Part II we'll discuss where this buffer SEP* BY 

i s * ) T h e f i 1 e I i s t c a n b e $ i v e n t o a ri y o f t h e a s s e m b 1 e r B L A N K S 
commands? Ay A:l. y or A2* You can also include in a file 

list the symbol @ in place of a file name* When the $ AS 

a s s e m b 1 e r en c o u n t e r s t h i s i t w :i. 1 1 e m e c u t e a P A U S E c o m •••• F I L E 

mandy and wou can use this pause to change diskettes in NAME 

case a source program is too Ions* to fit on one disk- CAUSES 

ette* PAUSE 

U n t i I y o u a r e u s e d t o t h e a s s e m b I era B E F R E <$ i v i n «* 
a command to invoke the assembler you should make sure 
y o i.j h a v e t a k e n c a r e o f t h e f o 1 1 o w i n tf p o i n t s * 

% * Check to make sure 8 and $ will be set properly y 
e i t h e r fro m t h e t e r m i n a 1 y o r p r e f e r a b 1 y f r o m 
within the source code by ORG or AORG and SORG* 



you will have to «?.*ive a Z or Z> command to pro? vent 
labels from bein& doubly defined* 

M a k e s u r e t h e re w i 1 1 b e e n o u $ h r o o m i r*i t h e m e m o r y 
for the symbol table* 

If you are assembling from disk there is a simple SORG 
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method for allocating memory* This method is used in T"+10 
s o 1.1 r e e p r o g r a m s s u p p 1 i e d w i t h D I S K A T E ? a n d a t f :i. r s t 

sight maw seem confusing!' so we'll look at it careful Iw PUTS 

t a see w h y i t w o r k s ♦ W h e n a s s e m ta 1 i n g b w g :i. v :i. n g a 1 i s t B J E T 

o f d i s k f i 1 e s ? t h e r e i s n o n e e d for a so u r c e a r e a a t C D E 

a 1 1 * However? y o u w i 1 1 n e e d t :l. * r o o m f o r t h e s y m h o 1 J U S T 

table? and 2* room for the object code* How do you BEYOND 

allocate this division? One method is to let the assem™ <T> 
bier do it for you by giving the following pseudo-op in 
y o 1..1 v s o u r e e p r o g r a m * 

SORG T'M-1.0 



This statement says to put the object code 10 bytes past 
the end of the symbol table* (The 1.0 byte cushion is 
J u s t t o p 1 a y i t s a f e ♦ > B u t ? a s y o u r p r o g r a m i s a s s e m • - 
bled? during Pass I the size of the symbol table is 
e >t p a n ded c o n s i d e r a b 1 y ♦ H o w d o e s t h i s s t a t e in e n t n o t 
result in having the symbol table clobber the beginning 
of the object code as more and more symbols are defined? 
The answer comes from an understanding of the separation 
of function of the two passes of the assembler* All 

symbols are defined during Pass 1. ? but no code is Verier 

a ted and the storage counter is not changed* The SORG 
statement DOES NOT TAKE EFFECT UNTIL PASS 2* Thus by 
this time the symbol table has been completely compiled? 
so the object code can safely be placed Just beyond it* 
If you use this method? though)' you must save the object 
code on disk before going on to assemble something else* 
A subsequent assembly definitely will cause the symbol 
table to begin overwriting the area of object code for 
t h e fir s t a s s e m b 1 y * 

There are a number of commands which are related to 
the process of assembling* Normally the assembler will 
produce a listing on your terminal of the source and 
object codes during Pass 2* In many cases? however? you 
will want to assemble a program without producing the 
listing* This is accomplished using the Q command? 
for Quiet* The Q command? which takes no argument? will 
cause the assembler to henceforth refrain from producing 
a listing during Pass 2* However? during both passes? 
i f t h e a s s e m b 1 e r w a s g i v e n a f i 1 e 1 i s t f o r i t s a r g u m e n t ? 
it will print on the terminal the name of the file 
c u r r e n 1 1 y b e i n g p r o c e s s e d ♦ As s e m b 1 e r e r r o r m e s s a g e s a r e 
always printed out regardless of any Q command* The 
assembler will also print the value of & in the current 
base on encountering a pseudo INTE or PROS* To cause 
the assembler to resume printing listings? give the J 
command? J for Jabber? also taking no argument* 

When 1 i s t i n g s a r e p r i n 1 0? d d u r i n g P a s s 2 ? t h e s o u r c e 
code is printed with a "tab" setting fori 



Q 
COMMAND 

CAUSES 
ASSEM- 
BLER TO 
QUIT 
MAKING 
LISTINGS 
DURING 
PASS 1? 



COMMAND 

CAUSES 
LISTINGS 
TO 
RESUME 



TAB 
COMMAND 

WITH NO 
ARGUMENT 
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I. * The label field WILL 

2* The opcode field PRINT 

3* The operand field CURRENT 

4* The comment field ASSEM- 

BLER TAB 
I... :i. i "i e n u in ta e r s w i 1 1 b e p r i n t e d a t t h e b e g i n n i n g o f t hi e S E T T X N S 
field for each source statement* The normal tab 

settings for these four fields ar&v repeotlvely ? 8 15 20 ARGUMENT 
29* In addition!' the entire source code field is offset IS LIST 
with respect to the left margin* to allow room for the OF 
"object code* This offset is normally 21* These values NUMBERS 
c a n b e c h a n g e d b y g :i. v :i. n g t h e T A B c o m m a n d * I f t h e T A B 
command is given with no argument* the current tab WHICH 
s e 1 1 i n g s w i 1 1 b e p r :i. n t e d o n t h e t e r in i n a 1 v f i r s t t h e f o u r R E P I.,. A C E 
settings for the four fields above? and last the source OLD 
code offset* To change the settings? give the TAB SETTINGS 
o o m m a n d w i t h a n a r g u m e n t c o n s i s t i n g o f a 1 i s t o f n u m b e r s 
separated by blanks? the order of the numbers again MM FITTED 
being the four fields above and lastly the offset* Note SETTING 
that the tab stops for the four fields ai-B each WITH KEEPS 
RESPECT TO THE MARGIN f THE SOURCE CODE OFFSET and not OLD 
w i t h r e s p <•? c t t o t h e p r e v i o u s t a b s t o p ♦ I n t h e I i s t o f V A L U E 
n i..i m b e r s g i v e n a s a r g i..i m e n t t o a T A B e o m m a n d ? t hi e f :i. v e 
n u m b e r s n e e d n o t a 1 1 b e g i v e n ♦ A n y t h a t a r e o m 1 1 1 e d 
w i 1 1 k e e p t h e i r o I d v a I u e ♦ 

In editim3 assembler source programs* you may want 
to keep the source code in as compressed a form as 
possible? to save storage* (Note that the Intel format 
i s i. j s u a 1 1 y more f r u g a I w i t h s t o r a g e t h a n t h e P r o o e s s o r P 
T e c h n o 1 o g y f o r m a t ? s i n c e y o u d o n '* t n e e d t o b e g i n a 1 i n e C (!) M M A N D 
w h i c h h a s n o I a b e I w i t h a b I a n k * ) D I S K A T E p r o v i d e s a n 
e d i t i n g c o m m a n d w h i e h w i 1 1 p r :i. n t a n i n t e r v a 1 i n t h e s a m e P R I N T S 
format as that used by the assembler? except there is no INTERVAL 
object code present? so that the tab stops are relative GIVEN AS 
to the left hand margin rather than the source code ARGUMENT 
o f f s e t ♦ T h e I i n e n u m b e r s w i 1 1 a I s o b e p r i n t e d ♦ T h i s i s I N 
the P command? which takes as argument any of the kinds ASS EM- 
o f i n t e r v a 1 s d i s c u s s e d a b o v e ♦ 7* h e P e o m m a n d w i 1 1 f o r m a t B L E R 
the printout in whichever of the Intel or Processor FORMAT 
Technology formats is current* If the source code 
c o n t a i n s I N T E o r P R S p s e u d o s ? t h e s e w i 1 1 N T c a u s e t h e 
P command to change formats* Thus the argument of the P 
command should not specify an interval that includes 
code with both formats* The P command WILL respond to 
I N T E or P R S c o m m a n d s g i v e n f r o m t h e t e r m i n a 1 ? s o i f t h e 
format is wrong one of these commands can be used to 
change it* 

The P command can also be used with ordinary text to 
o b t a i n I i n e n u m b e? r s ? f o r r e f e r e n c i n g w :i. t h a r g u m e n t s I i k e 
n ! ? b u t t h e I i n e s w i 1 1 c o m e o u t I o o k i n g r a t h e r p e c u I i aw 
s i n c e t h e « w :i. 1 1 b e f o r m a 1 1 e d a s i f t h e y w e r e a s s e m b 1 e r 
s o i..i v c e s t a t e m e n t s ♦ 
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There are several ERROR' CODES that the assembler ASSEMBLY 
w i 1 1 g e n e r a t e :i. f i t f :i. n d s s o m e t h i n si wro n g i n w o u r s o u r c e E R R R S 
c o d e ♦ I f an A » A 1 y or A 2 c o m m a n d r e s u 1 t s :i. n a s s e m b 1 e r T E R M I N - 
e r r o r s y t h e m e s s a g e X A T E A 

COMMAND 
ASSEMBLY ERRORS? STRING 

w :i. 1 1 b e p r i n t e d o n t h e t e r m :i. n a 1 w h e n e y, e c u t i o n o f ' t h e 

co mm and is finished? and if the command was part of a 

larger command string? such as a macro or multiple- 

c o m m a n d o o m in a n d 1 i n e y t h e o o in m a n d s t r i n g w i 1 1 a ta o r t :i. n 

t h e s a m e w a y a s f o r a n y o t h e r D 1 S K A T E e r r o r * T h e E R R (!) R 

in e a n :i. n g o f t h e e r r o r c o d e s i s a s f o 1 1 o w s * C D E S 

A A r g u m e n t E r r o r ♦ T h e o p e r a n d f i e 1 d :i. s :i. n v a J. i d f o r t h e 
g i v e n o p c o d e ♦ T h :i. s w i 1 1 a 1 s o o c c u r a t a s t a t e m e n t 
1 b 1 a f t e r a n I E p s e u d o o f t h e f o r m 1 E e x p r e s s i o n ? 1 b 1 
if the expression refers to an undefined variable* 
The A code usually occurs on 1m in Pass 2* though an 
i n v a 1 i d E Q U oper a n d y f o r i n s t a n o e 9 w i 1 1 a u s e i t t o 
occur in Pass 1. * 

M Miss ins* Label* An EQU statement occurs without a 
1 a b e 1 * P r i n t e d d u r i n g h o t h p a s s e s ♦ 



D D o u b 1 y D e f i n e d L a b e 1 * A 1 a b e 1 i s g :i. v e n w h e r e t h e 
label is identical to a symbol already defined* 
E a i 1 i n si t o g i v e a Z o r 7. > o o m m a n d a f t e r a p r e v i o u s 
a s s e m b 1 y w i 1 1 u s u a 1 1 « ?^ e n e r a t e o u i t e a f e w o f t h e s e ♦ 

L Label Error* The first character in a label field is 
not b\i upper ■•••case letter of the alphabet* When this 
o c c u r s y 3 N P s w i 1 1 b e «* e n e r a t e d i n p 1 a o e o f t h e 
s t a t e m e n t ♦ T h i s e r r o r cs n o c c u r esp e c i a 1 1 y i n 
Processor Technology format if there are extraneous 
characters in the source code* 

Opcode Error* The opcode field is not a proper op-- 
c o d e o r p s e u d o ••■• o p * 3 N P s w i 1 1 b e «f e n e r a t e d i n p 1 a e 
o f t h e s t a t e m e n t ♦ 

To conclude this sect i on v let's look at a simple 
example of an assembler program which performs a useful 
f u n c t i o r» ♦ We've a 1 r e a d h s e e n t h a t D 1 S K A T E s « m b o 1 t a b 1 e s 
are kept in a format consisting of* (1.) the characters 
of the symbol y with the last character having the high- 
order b i t s e t y f o 1 1 owe d b y < 2 ) a 1 6 - b i t n u m b e r «l i v i n g 
the value of the symbol? (3) with a at the end of the 
table* It would be useful to have a simple program 
which will print out a symbol table* The example below 
w i 1 1 p r i n t o n t h e t e r m i n a 1 t h e e n t i r e c u rre n t s w m b o 1 
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table <T>* Because the pros! ram uses D I SKATE 's own 
i n t e r h a 1 p r i n t r o u t i n e s ? a 1 1 o f t h e u s u a 1 c o n v e n t :i. o n s 
resfardinsf the panic state ? current base etc* apply 
precisely as if this were a normal DI SKATE command* 
S o m e c o in m e n t s a b o u t t h e p r o g r a m * F :i. r s t ? 1 1 i s 
wuite elementary ? doing only the minimal in the way of 
formatting the output? and the symbol table is not 
sorted* The symbol is printed ? then two spaces? then 
the value of the symbol in the current base* You could 
make it a bit more elegant by having the symbol printed 
out in a sfiven column* There are three labels not 
defined within the program* These are GUT? which prints 
o n e c h a r a o t e r o n t h e t e r in i n a 1 ? P H I... S B ? w h 1 c h p r i n t s o n 
the terminal in the current base the value in the HI... 
r e g 1 s t e r p a i r ? a n d S Y M *T' B w h i e h i s t h e a d d r e s s o f t h e 
pointer to the beginning of the symbol table* Where did 
the addresses come from for these three labels? This 
(a u e s t i o n i s d i s c u s s e d t h o r o u g h 1 y i n P a r t 1 1 ? b u t t o ...i u in p 
the gun a little bit*- your version of D I SKATE is provi- 
ded with a file called ATE TBI...* This file is art abbrevi- 
a t e d v e r s i o n o f t h e s y m b o 1 t a b 1 e f o r a n a s s e m b 1 y o f 
D 1 S K A T E ? a n d a c o m p 1 e t e 1 i s t o f a 1 1 t h e s y m b o 1 s i n :i. t 
and their meaning can be found in Part 111* This table 
provides the addresses for a number of internal Dl SKATE 
routines and registers* As mentioned above* the table 
can be made into the current symbol table by the 
commands* 

I... ATETBL <T> 
KEEP=0 

T h e n t o z e r o a 1 1 o f t h e n e w s « in b o 1 s d e f 1 n e d d u r 1 n g t h e 
assembly of this program? the command Z>KEEP can be 
given* The addresses for OUT and PHI... SB have come from 
t h i s t a b 1 e ♦ It s h o u 1 d b e e m p h a t i c a 1 1 y e m p h a s i z e d t h a t 
i n t h e 1 i s t i n g below? t h e s e a d d r e s s e s refer t o t h e 
corresponding locations ONLY IN THE VERSION OF DISKATE 
CURRENTLY BEING USED BY THE AUTHOR OF THIS MANUAL* IN 
YOUR VERSION THEY WILL ALMOST CERTAINLY NOT BE THOSE 
SHOWN IN THE LISTING!! In no case should you take 
addresses for OUT and PHI... SB by reading them off from the 
object code of this listing* All of this is more fully 
d i s c u s s e d i n P a r t 1 1 * 

The program is set to be executed from location 
7F00H* By storing the object code in a file called 
PRNTSYM? the symbol table can be printed by giving the 
D I S K A T E c o m m a n d * 

GO PRNTSYM 

which will load the object code? and then execute the 
eauivalent to the command X<R>* The RET at the end of 
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th e program will return control to D I SKATE* After the 
assembly* the object code can be stored by the command* 

S PRNTSYM PRNTSYM* *SYMEND 

N o t :i. c e t h a t :i. n t h i s e o m m a n d 9 t h e f i r s t t i m e P R N T S Y M :i. s 
used it is a file name? and the second time it is used 
it is a symbol in the symbol table* There is no 
ambiguity here? but if you find it confusing you can use 
a d i f f ere n t n a m e for t h e f i 1 e c o n t a i n i n si t h e p r o g r a m a n d 
an assembler label for the program itself ♦ 

H e r e i s t h e 1 i s t i n g o f t h e p r o g r a m 9 e >c a c 1 1 y a s g e n •••• 
e rated by the assembler* The source code was assembled 
d i r e c 1 1 y f r o m t h e d i s k f i 1 e P R N T S Y M S » a n d t h e t a b s e t 
t i n g s w e r e a d J u s t e d b y e h a n g i n g t h e 1 a s t s e 1 1 i n g 9 i * e * 
the source code offset? to 15* 



>A PRNTSYMS 

PRNTSYMS 

PRNTSYMS 



INTE 











2 










3 










4 

IS* 










6 


7F00 








7 

8 


7F00 


2A 


5B 


45 


9 
10 


7F03 


7E 






1 1 


7F04 


B7 






12 


7F05 


CA 


38 


7jr 


13 
14 


7F08 


7E 






15 


7F09 


47 






16 


7F0A 


EA 


80 




17 
18 


7F0C 


C2 


17 


7F 


19 


7F0F 


78 






20 


7F10 


CD 


38 


35 


21 


7F 13 


23 






22 


7F14 


C3 


08 


7F 


23 
24 
25 


7F17 


78 






26 


7F18 


E6 


7F 




*?7 


7F1.A 


CD 


38 


35 


28 


7F ID 


3E 


20 




29 


7F1.F 


CD 


38 


35 


30 


7F22 


CD 


38 


35 


31 



ORG 7F00H 

prntsym t lhld symtb 
symbeginj mou a?m 

DRA A 

jz symend 
symloop: mou a?m 

MOU B*A 

ani boh 
jnz endsym 

MOU A*B 
CALL OUT 

:i:nx h 

jmp symloop 



ENDSYM t MOU A*B 
ANT 7FH 
CALL OUT 
MUX A*' 
CALL OUT 
CALL OUT 



PROGRAM TO PRINT 
SYMBOL TABLE 



SET POINTER 

GET SYMBOL 
SET FLAGS 
QUIT IF 

GET SYMBOL LETTER 
SAUE COPY 
CHECK HIGH 
ORDER BIT 
JUMP IF ON 
RESTORE LETTER 
PRINT LETTER 
INCREMENT POINTER 
GET NEXT LETTER 



RESTORE LETTER 

STRIP OFF BIT 

PRINT OUT LETTER 

PRINT OUT A 

SPACE 

AND ANOTHER 



D I SKAT E U ser's Ma n u a 1 



•90- 



7F2I5 


23 




7F2.6 


5E 




7F27 


23 




7F28 


56 




7P29 


23 




7F2A 


E5 




7F2B 


EB 




7F2C 


CD 


E2 


7F2F 


3E 


0D 


7F3I. 


CD 


38 


7F34 


El 




7F35 


C3 


03 



34 



35 



7F 



7F38 



C9 



32 
33 
34 
35 
16 
37 
38 
39 
40 
41 
42 
43 
44 
A'5 
46 
47 
48 
49 



INX 


H 


A 

9 


MOV 


EyM 


A 

V 

A 


:i:nx 


H 


y 

y 


MOV 


DvM 


A 

y 


INX 


H 


A 

y 


PUSH 


H 


A 
9 


XCHG 




A 

y 


CALL. 


PHLSB 


y 
y 


MVT 


Ay 13 


A 

9 


CALL 


OUT 


9 


POP 


H 


V 


JMP 


SYMBEGIN 


A 

y 



SYMENDt RET 



INCREMENT POINTER 
LOW ORDER 
SYMBOL VALUE 
INCREMENT POINTER 
HIGH ORDER 
INCREMENT POINTER 
SAVE POINTER 
HI... CONTAINS 
SYMBOL VALUE 
PRINT VALUE 
CARRIAGE RETURN 
PRINT CRvLF 
RESTORE POINTER 
GET NEXT SYMBOL 



RETURN TO D I SKATE 



N o t i o e t h a t D I S K A T E w :i. 1 1 g e n e r a t e I i n e n u m b e r s * 
The reason for having line numbers is to correlate with 
the error m e s s a g e s * A I i n e n u m her M U S T N T b e g :i. n a 1 i n e 
in the original assembler source code* If wou want to 
use line numbers for your own reference in the source 
c o d e y a n d t h e P c o m in a n d w i 1 1 n o t s u f f :i. c e y t h e 1 1 n e n u m - 
hers must be part of the comment field* The format in 
t h i s e >i a m p I e y o f c o u r s e y i s I n t e I * B \-.t w a w o f c o n t r a s t y 
here is how the original source code looks J 

INTE 



5 PROGRAM TO PRINT 
y SYMBOL TABLE 

A 

9 

ORG 7F00H 
y 

prntsym: LHLD SYMTB y SET pointer 

A 

y 

symbegin: MOV AyM 9 GET symbol 

ORA A 5 SET FLAGS 

JZ SYMEND 9 QUIT IF 

A 

y 



SYMLOOP 



MOV AyM 



GET SYMBOL LETTER 



MOV By A y 
AN I 80H y 
y ORDER BIT 
JNZ ENDSYM 
MOV A y B y 
CALL OUT y 



SAVE COPY 
CHECK HIGH 

5 JUMP IF ON 
RESTORE LETTER 
PRINT LETTER 



INX H 



INCREMENT POINTER 
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...JMP SYMLOOP ? GET NEXT LETTER' 



ENDSYMJ MOM A»B J RESTORE LETTER 

AN I 7FH f STRIP OFF BIT 

CALL OUT 5 PRINT OUT LETTER 

MVI A*' ' f PRINT OUT A 

CALL OUT 5 SPACE 

CALL OUT f AND ANOTHER 

INX H * INCREMENT POINTER 

MOV E»M i LOU ORDER 

9 SYMBOL VALUE 

INX H 9 INCREMENT POINTER 

MOV D*M y HIGH ORDER 

INX H v INCREMENT POINTER 

PUSH H ? SAVE POINTER 

XCHG S> HI... CONTAINS 

$ SYMBOL VALUE 

CALL PHLSB" 5 PRINT VALUE 

MVI A* 13 9 CARRIAGE RETURN 

CALL OUT 9 PRINT CRrLF 

POP H 9 RESTORE POINTER 

JMP SYMBEGIN % GET NEXT SYMBOL 



SYMEND* RET * RETURN TO DISK ATI 



Obviously 9 the assembler listing is far more intel- 
1 i g i b 1 e 9 whereas t h e o o in p r e s s e d f o r m a t o f t h e o r i g i n a 1 
source code saves on storage* The listing generated bw 
the P command is identical to that given taw the assem- 
bler 9 except that it includes no object code* (Of 
c o u r s e i t c a n happen t h a t a I i n e w h i c h i s t o o I o n g i n 
t he a s s e m b 1 e r 1 i s t i n g w i 1 1 n o t be i n t h e P c o m m a n d 1 i s t - 
ing*) One note* The program assumes that the Processor 
Techno logw format might be in force before it is assem- 
bled 9 so the INTE pseudo begins in column 2 to indicate 
art emptw name field* If the Intel format is in force 
t h e n t he lack of a c o I o n a u t o m a t i c a 1 1 w i n d i c a t e s a n 
emptw name field* 
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Invoking DISKATE 



I n t h i s s e c t i o n we w :i. 1 I d :i. s e u s s t h e v 3 r :i. o u s w a y s o f T 
invoking DI SKATE v including the power- up procedure* It POWER UP 
mi&ht seem like a dirty trick to have put off the power- 
up procedure until so late into the manual? taut there is LOAD & 
a good reason for it* When D I SKATE initializes it EXECUTE 
i s s 1. j e s i n t e r n a 1 1 y c o m m a n d s t h a t a r e e w a c 1 1 y 1 i k e s o m e T 
«ou might give yourself from the terminal* so it is 
i in p o r t a n t t o h a v e a n u n d e r s t a n d i n g o f h o w t h e y w o r k ♦ v" E R S I N 
F :i. r s t a w o r d a ta o u t h o w D I S K ATE i s o r g a n i z e d * D I S K A T E P R U I D E D 
a o t u a 1 1 y o o n s i s t s o f t w o s e p a r a t e b u t 1 i n k e d p r o g r a m s * B T - 
ATE and 10* ATE consists of everything but the 1/0 STRAPS 
r o 1..1 1 i n e s v a n d i s c o m p I e t e 1 y i n d e p e n d e n t o f a n y p a r t i c 1..1 - X (!) 
lar I/O or disk configuration* 10 contains the I/O 
r o u t i n e s y i n c 1 u d :i. n g t h e d i s k d r :i. v e r s ? a n d a I s o o o n t a :i. n s 
a loader which loads ATE* To bring up 01 SKATE? all you 
do is instruct your system to load and execute 10* If 
your disk will allow any program to be bootstrapped? as ATE MUST 
does t h e D i s k. J o c k e y y y o u w i 1 1 p r o b a b 1 y w a n t i t t o ta o o t - B E 2 N D 
strap 10* This is the way D I SKATE is provided* If you ENTRY IN 
are using the North Star disk then D I SKATE can tae D I R EC- 
tar ought up with the DOS command GO 10* There is one TORY 
very important point here if you go to create another 
copy of DISKATE on another disk* 10 ASSUMES THAT ATE IS 
THE SECOND ENTRY IN THE DIRECTORY* If you use DISKATE 
to create another copy of itself y you must make sure 
t h a t t h i s h o I d s ♦ 

When 10 ha s I o a d e d A T E y i t w i 1 1 t r a n s f. e r c o n t r o 1 t o 

it* Initialization then takes place* This includes ON 

e x e o u t i n g the c o m m a n d s t r i n g * P W E R • •• U P 

COMMAND 

0>ZvY 00 

STARTUP 

The last thing DISKATE does at power -up is to execute IS 

the command* EXECUTED 

GO STARTUP 

STARTUP 

S T A R T U P as p r o v i d e d i s a n o r d i n a r y s o u r c e f i I e * T o s e e P E R F R M S 

w h a t i t c o n t a i n s i n y o u r v e r s i o n v type Or I... S T A R T U P y " ♦ ♦ ( J S E R ' S 

T h e S T A R T U P f i 1 e c a n h e u s e d t o i n i t i a 1 i z e w o u r o un IN I T I A L 

variables which you want to have a value every time you IZATI0N 
use DISKATE* H o w e v e r y s i n c e t he GO o o m m a n d w i 1 1 e i t h e r 
L and D a source file or I... and X a n on- source file* the 
STARTUP file can also be a machine language program* 
If you create a new copy of DISKATE r you might happen 

to forget the STARTUP file* This is not serious* In ENTRY 

this case DISKATE will issue an error message that it POINT 

can't find STARTUP y and then take commands from the TO 

terminal as usual* You can edit STARTUP Just as you INITIAL- 
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would any other file* 

Now suppose you want to leave D I SKATE for another 
program* such as a DOS* which will be co-resident with 
D I SKATE* and then return to DISKATE* What entry point 
should you use? There are two* If you give an X 
command for the disk containing D I SKATE* the address for 
the file ATE will give you the entry point which causes 
initialization* You can Jump to this address from a 
front panel* DOS* or a piece of software* To re-enter 
D I SKATE without full initialization* the entry point 
RENT as given in ATETBI... can be used* To find out its 
v a 1 u e * m o i..i n t t h e d i s k provided a n d t y p e t h e c o m m a n d ♦ 



IZE IS 
LOAD 
ADDRESS 
OE ATE 



REENTRY 
POINT 
GIVEN BY 
SYMBOL 
RENT IN 
ATETBI... 



L ATETBL <T>*KEEP~0* TRENT 

In DISKATE release .1*0 this entry point is 12 bytes 
beyond the beginning of ATE* though this might change in 
the future* Jumping to this entry point WILL initialize 
the stack* but will not change the pointers to <S>* <E> 
etc* In Part II we'll discuss how a machine language 
program can call DISKATE as a subroutine and ha\/B 
DISKATE return to it* If you Jump to RENT in such a 
situation* the stack in the program from which you Jump 
will be lost* 

You might want to reload DISKATE from the disk* in 
case something serious has gone wrong* 10 will write at 
memory location 3 a Jump to 10* Since 10 begins with 
the loader for ATE* you can reload DISKATE by Jumping to 
memory location 3* so long as the area of memory occu- 
pied by 10 is intact* To do this from within DISKATE* 
you can give the command* 



10 PUTS 

JUMP TO 

LOADER 

AT 

MEMORY 

LOCATION 

3 

TO 

RELOAD 
DISKATE 
JUMP TO 
3 IE 10 
INTACT 



X3 



In addition to these entry points t DISKATE provides 
some recursive features whereby it can be invoked from 
within DISKATE* These commands allow a macro to issue a COM 
prompt* accept a DISKATE command* and then resume* The COMMAND 
command COM* for command* takes as argument a string 
enclosed in brackets* When this is executed* the string PRINTS 
is printed on the terminal as a prompt? and then the STRING 
DISKATE prompt character will appear* You can then type GIVEN AS 
in one "command line"* which may include a multi-line E ARGUMENT 
command* When the command has been executed* execution E0R A 
of your macro will resume* Here's an example of how PROMPT* 
this can be used* Suppose in loading files you want to ACCEPTS 
have a way to prevent yourself from giving an I... command ONE 
without first having given an command* That way you COMMAND 
will avoid clobbering the wrong part of the memory* You 
can do this by having the following macro tucked away in 
an out of the way place in the memory* 
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a Jump to the 
be reiniti a I •••• 
their old 



y X 9 COM i: TYPE LOAD COMMAND 1 y " ♦ ♦ 

The best way to invoke the macro is to set a variable 
eoual to the address of the macro y then give the command 
D variable* Note that the macro can be loaded and the 
v a r i a b 1 e s e t t o i t s location by t h e S T A R T U F : ' f i 1 e ♦ I n 
using this method you must be very careful that the 
macro DOES NOT RESIDE XN THE SOURCE AREA* since the 
c o m m a n d :i. n t h e m a c r o c o 1 1 a p s e s the source a r e a ♦ 

Us in 3 the COM command can be slightly tricky y since 
v* o 1 1 c a n e a s i 1 y g e t c o n f u s e d a b o u t w h e t h e r y o u a r e t a 1 k •• 
i n g t o t h e t e r m :i. n a 1 a t t h e " g r o u n d 1 e v e 1 ■ o r v i a a C (!) M 
c o m in a n d ♦ X f y <:) u g :i. v e a n E S C t o t h e c o m m a n d 1 i n e b e ;i. n g 
typed in response to a COM command? DX SKATE expects the 

1 i n e t o b e r e t y p e d * n r e c e i p t o f t h e 1 i n e y w h a t e v e r 
process contained the COM command continues* Thus typ- 
ing ESC to a command expected by the COM command DOES 
NOT return you to the ground level* If you want to 
return to the ground level when DX SKATE expects a com- 
mand line for a COM command y you can give the command 
RENT* for Reenter* This command performs 
D I S K A T E r e © n t r y I o c a t i o n * T h e s t a e k w i 1 1 
i z e d y b u t a 1 1 o f y o u r y/av i a b I e s w i 1 1 k e e p 
values* 

Note t h a t t h e C M c o m m a n d w i 1 1 acce p t o n I y a s i n g I e 
command y and then returns to the process that invoked 
i t ♦ T h e r e i s a s i m i 1 a r c o m m a n d y A T E y w h i c h w h e n e x e c »..i - 
ted CALLS DISKATE RECURSIVELY* The ATE command allows 
you to give DISKATE any number of commands y precisely as 
if you were talking to the "ground level" DISKATE* An 
e r r o r w i 1 1 c a u s e t h e error m e s s a g e to b e p- r i n t e d y b u t 
you will NOT be returned to the ground level* Instead 
y o i..i w i 1 1 s t i 1 1 b e w i t h i n t h e i n v o k a t :i. o n o f D I S K A T E w h i c h 
is a subprocess of whatever process contained the ATE 
command* Then when you give the BYE command y DISKATE 
returns to the process that invoked the ATE command* As 
with COMy ATE takes as argument a string enclosed in 
brackets which it prints on the terminal as a prompt* 
The ATE command can be used to create macros which han- 
dle v a r i o u s f u n c t i o n s a u t o m a t i c a 1 1 y y b u t w h e r e y o u w a n t 
to leave some "holes" for doing work with an indefinite 
number of DISKATE commands yourself* Here's an example 
of how you might use this* Consider the following 
macro* 

R-1.y"<F> !>+:!. yATETPOINTER IS NOW AT END OF FILERS " ** 



RENT 
COMMAND 

JUMPS TO 
REENTRY 
POINT 
(GROUND 
LEVEL) 
INITIAL- 
IZES 
STACK 
ONLY 



ATE 
COMMAND 

PRINTS 

AS 

PROMPT 

THE 

STRING 

GIVEN AS 

ARGUMENT y 

ACCEPTS 

ANY 

NUMBER 

OF 

COMMANDS 

RETURNS 
WHEN 
GIVEN J 

BYE 
COMMAND 



Suppose you begin your editing work by loading a file 
a n d t h e n i n v o k i n g t h i s ma c r o ♦ T h e m a c r o w i 1 1 m a k e 
o e r t a i n t h a t w o u s t a r t t o w o r k w i t h t h e e n t r « p o i n t e r a t 
t h e e n d o f t h e file* D I S K A T E w i 1 1 i s s u e t he y^r o m p t y a n d 
then you can give any number of editing commands* Then* 
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you stive the BY Hi! command to resume with the macro* This 
w i 1 1 a u t o m a t i c a 1 1 y s t o re the f i 1 e o n t h e d i s k v re s t o r e 
the entry pointer to the end of the filer and then issue 
the prompt and wait for more commands* As long as none 
of the editing commands you type in response? to the ATE 
c o m m a n d c h a n g e s t h e 1 a t e s t f i 1 e r e f e r e n c e * t h i s m a c r o 
w i 1 1 a ,'!. 1 o w y o u t o d o a n y e d i t i n g w o r k w o u w a n t v a n d w i 1. 1 
a i..i t o m a t i o a 1 1 w h a n d 1 e s t o r i n g t h e f i 1 e on t h e d i s k a n d 
restoring the entry pointer* If properly written v such 
m a c r o s c a n d e c r e a s e t h e I i k e 1 i h o o d o f c a t a s t r o p h i c 
err o r s s i g n i f i c a n 1 1 y * 

One final point* Although this is discussed in 
d e t a i 1 i n P a r t I X ? we m u s t n o t e t h a t D I S K A T E c a n ta e 
c a 1 I e d b y o t h e r m a c h i n e 1 a n g u a g e p r o $ r a m s * I' n a d d i t i o n 
to the Jump to 10 written at memory location 3v a Jump 
is written at location to a special HI SKATE entry 
point called ATECOMS* This entry point will cause 
DI SKATE to foe called as a subroutine!' with the HI... 
register pair pointing to a string of D I SKATE commands* 
This s t r i n g w i 1 1 b e e x e c u t e d v a n d t he n o o n t r o I w i 1 1 b e 
r e t u r n e d t o t h e c a 1 1 i n g p r o g r a m ♦ I n t h i s c a s e i f t h i s 
string does not cause D I SKATE to leave the "ground 
1 e v e 1 " 9 t h e n t he BY E c o m m a n d w i 1 1 c a u s e c o n t r o I t o be 
r e t u r n e d t o t h e c a 1 1 i n g p r o g r am* N o t e h o w e v e r t h a t 
invoking the entry point RENT? either by a RENT command 
o r b y J u m p i n g t o t h e e n t r y p o i n t R E N T y w i 1 1 c a u s e 
reentry at the ground level and the return address to 
DISATE's caller will be lost* If you are at the ground 
lev e I a n d there was n o c a 1 1 i n g p r o g r a m y i ♦ e ♦ y o u i n v o k e d 
D I SKATE by the usual power -up procedure 9 then the BYE 
command will cause D I SKATE TO BE RELOADED FROM THE DISK* 



BYE 

COMMAND 

AT 

GROUND 

LEVEL 

RETURNS 

TO 

CALLING 

PROGRAM 

IE THERE 
IS NONE 
CAUSES 
DISKATE 
TO BE 
RELOADED 
EROM 
DISK 



RENT 
LOSES 
RETURN 
ADDRESS 
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P a r t I I I n s t a 1 1 a t i o n a n d M a :i. n t e n a n e e 
1 1 ♦ 1 Br i. n g :i. n g u p D I S K A T E 

T h e v © r s :i. o n o f D I S K ATE s u p p 1 i e d w :i, t h t h e D :i. s It. B A U D 

Joekes controller comes reads to run with a serial ter RATE FOR 

iTtinal attached to the Disk Joekes serial I/O port* If SERIAL 

y o u have a s e r :i. a I t e r in i n a 1 v a 1 1 a c h i t t o t h i s s e r i a 1 T E R M I N A I. . 

port artd set the terminal to run at at 1200 baud* Then ON D*J* 

a 1 1 s o u h a v e t o d o i s b o o t s t r a p t h e D I S K A T E d i s k e 1 1 e a n d I S :! 2. 
sou should be up arid running* If sou have a serial, 

terminal and want to run it from another I/O hoard? the 15 1 SKATE 

best thins to do is bring up D I SKATE from the serial READY TO 

terminal on the Disk Jocks y then use D I SKATE itself to RUN WITH 

customize sour I/O routines* If sour terminal hardware SERIAL 

i s n o t s i m p I s a s e r i a I t e r m :i. n a 1 » o r i f i t i s a s e r i a I T E R M I N A L 

t e r m i n a I b u t w o n ' t r u n a t 1 2 b a u d ? t h e n s o u w i 1 1 h a v e N N E C -- 

to make some minor patches* Before describing the patch- TED TO 

ins* procedure in detail? here is the General structure D*J* 
o f h o w D I S K A T E i s b r o u g h t u p ♦ As in e n t i o n e d i n P a t % t I ? 
D I S K A T E o o n s i s t s o f t w o i n d e p e n d e n t b u t 1 i n k e d m o d u I e s * 

10 and ATE* 10 contains all of the I/O drivers includ- ATE MUST 

i. i "i si t ft o s e for t h e d i s k ♦ 1 1 a I s o c o n t a i n s a I o a d e r w h i c ft B E 2 N D 

looks in the directors for ATE? which IT ASSUMES IS THE FILE IN 

SECOND ENTRY IN THE DIRECTORY* and loads it* 10 writes DIREC- 

a Jump to the beginning of 10 at memory location 3* This TORY 
Jump' is the on Is link ATE has to 10* Thus ATE and 10 can 
be positioned in the memors complete Is independent Is* 

The beginning of 10 is a JUMP TABLE to all of the 

I / d r i v e r s D I S K A T E w i 1 1 n e e d * T h e i n i t i a 1 p o w e r •- u p T 

procedure if sour terminal ssstem is not connected to BEGINS 

the Disk .Jocks serial port is to bootstrap as if sou WITH 

were? a n d t h e n t o p a t c h i n t o t h :i. s ,. j u m p t a b I e ♦ We" 1 1 J U M P 

d i s c u s s the firs t p a r t o f t h e J »..i m p t a b 1 e f i r s 1 9 b e c a u s e TAB L E 
the first part deals with the terminal 1/0 and the 

second part deals with the disk drivers* Here is the 1ST 

format for the beginning of 10* JUMP TO 

LOADER m 

L o c a t i o n C o n t e n t s T H E N 

TERM IN AL- 
IO JMP Loader 1/0 
10+3 JMP Character Output Routine DRIMERS 
10+6 JMP Character Input Routine 
1 + 9 J M P T e r m i n a I I n i t i a 1 i z a t i o n R o u t i n e 
10+12 JMP Panic Detect Routine 

In the standard version cur rent Is provided? 10 begins at 
0100H* 

A Jump to the loader begins the Jump table* Thus 
D I SKATE can be reloaded at any time bs Jumping to 10* 
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Th© general procedure for getting started with a termin- 
al either not connected to the Disk Jockey or a serial 
terminal such as a TTY that won't run at 1200 baud is 
as follows* 

1 ♦ Bo o t s t r a p i n t h e d i s k e 1 1 e a n y w a y ♦ T h e s y s t e m w i 1 1 
n o t r e s p o n d * b u t t h a t d o e s n ' t m a 1 1 e r * 

2* Stop the machine* and using a front panel or moni- 
t o r » i n s t a 1 1 w o u r o w n 1 / r o u t i n e s :i. n t h e c o m p u t e r ' s 
m e m o r y * T h e g u i d e 1 i n © s t h a t t h e s e r o u t i n e s m u s t 
satisfy sr^ given below* A safe place to put them 
when you first bring up D I SKATE is the 256 bytes 
from 2900H to 29FFM* Once you have DT SKATE running 
you can use it to incorporate your 1/0 routines 
within 10 ♦ If your I/O routines won't fit in 25 A 
bytes* use the top of the memory available* 

3* Again using a front panel or monitor* change the 
.jumps in the Jump table to Jump to your I/O rou- 
tines* Be sure to remember that the addresses of 
the Jumps must be stored with the low order byte 
first* 



DURING 

FIRST 

STARTUP 

I/O 

ROUTINES 

CAN 00 

AT 

2900H •♦ * 

29FFH 



4* Cause your system to begin executing instructions at 
the beginning of 10* This should be 0100H 
( 1 1 Q ) * u n 1 e s s y o u r vers i o n o f D I S K A T E c o m e s 
with a corrections sheet indicating a different 
starting address* The module ATE will be reloaded 
f r o m t h e d i s k * a n d a t t h i s p o i n t a s t a r t - u p m e s s a g e 
should b^^^bv on the screen and then the prompt 
symbol* ">"♦ 

5* Once D I SKATE is running 9 the source code for 10 is 
contained in the disk file SYS 10* This should be 
reassembled to contain your own 1/0 routines* so 
t h a t t hey w i 1 1 a u t o m a t i o a 1 1 y b e 1 o a d e d w h e n D I S K A T E 
i s boo t s t r a p p e d ♦ 1 f w o u r I / r o u t :i. n e s a r e i n P R M 
or otherwise manage to find their way into the 
memory without needing to be loaded within 10* 10 
should be reassembled so that the Jump table con- 
tains the proper Jumps* 

The procedure for connecting a serial device that 
won't run at 1200 baud* such as a TTY* to the Disk 
Jockey serial port* is a special case that is somewhat 
simpler* In this case the only thing that will have to 
be patched is the instruction which loads the baud rate 
constant for the serial 1/0 port* Here is what you do* 

1 * b t a i n t h e a d d r e s s o f t h e t e r m i n a I i n :i. t i a I i z a t i o n 
routine from the Jump table* The low order byte of 



AFTER 
PATCHING 
JUMP TO 
0100H 
UNLESS 
OTHER- 
WISE 
INDICA- 
TED ON 
CORREC- 
TION 
SHEET 



TO RUN 

SERIAL 

TERMINAL 

FROM 

D * J ♦ 

PORT AT 

OTHER 

THAN 

1200 
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th is address is at 10+10 and the high order byte at 

10+1.1* PATCH 

SPEED 
2* Unless otherwise indicated in a corrections sheet* CONSTANT 
the first byte of the terminal initialization rou- LOAD 
t i n e w i 1 1 h e a N P * o r ♦ T h e n e x t i n s t r u c t i o n w i 1 1 I N 
he J TERMINAL 

INITIAL - 
m n e m o n i e s o c t a 1 h e x 1 2 A T 1 N 

ROUTINE 
LXI H* 041.0 041. 041 000 2.1. 21. 00 

ADDRESS 
This is the instruction which loads the initial OF THE 
speed constant for the Disk Jockey serial port* ROUTINE 
Consult the Disk Jockey manual to find the speed AT 10+10 
constant for the baud rate you wantv then patch it 
in in place of the 041. 000 octal or the 21 00 hex in 
this instruction* Be sure to patch only the address 
portion of the instruction and not the opcode y and 
be sure to enter the speed constant as a 1.6 bit 
address y low order byte first* 

3* .Jump to the beginning of 10* There is no need to 
patch anything in the Jump table* 

n c e y o u h a v e D I S K A T E u p f o r t h e f i r s t 1 1 m e * t h e 
next thing you will want to do is to customize your 1/0 
routines* unless you should happen to want to run from 
the on-board serial port at 1200 baud indefinitely* 
We've see n t h a t t h e in o d u 1 e 1 b e g i n s w i t h a J u m p t a b I e * 
and that the four Jumps after the first Jump to the 
loader are for the terminal 1/0 routines* Here are the 
g i..i ;i, d e I i n e s w o u w i 1 1 n e e d f o r y o u r o w n t e r m i n a 1 r o u t :i. n e s * 

1. ♦ A 1 1 o f t h e f o u r t e r m i n a I I / v o u t i n e s w i 1 1 b e p a s s e d 

a n u m b e r i n t h e A r e si i s t e r w h i c h w i 1 1 s e r v e as a D E V I C E 

NUMBER* Initially this device number is 0y and is DEVICE 

change d b y a n 1 c o m m a n d ♦ I f y o u d o n ' t h a v e m u 1 1 i p 1 e N U M B E R 

1/0 devices this feature can be ignored* If you have IN 

both a video terminal of some kind and a printer y for A 

example* then you could have the output routine check REGISTER 

t h e A re g i s t e r for 0? b r a n c h i n g t o t h e p r i n t e r d ri^er i f 

the A register is not 0* Note that the 10 command will 

e a u s e i t s a r g u m e n t t o b e s i j p p I i e d t o a 1 1 t h e t e r m i i"i a I 

1/0 routines in the A register* Thus your character 

input routine should always go to the keyboard* unless 

you have more than one keyboard* You can have up to 256 

different devices — the may, 1 mum number of codes that CHAR OUT 

can be contained in the A register* PRINTS 

CHAR IN 

2 ♦ T h e c h ara e t e r o u t p u t r o u t i n e s h o u I d p r i n t o n t h e B 

t e r m i n a I t h e c h a r a c t e r s u p p I i e d i n t h e B r e g i s t e r * B e R E 1 8 T E R 
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verw careful not to make the mistake of printing the 
character in the A register — remember this is the 
device number* 

3* The character input routine should return the input 
character in the A register * replacing the device num- 
ber* 

4 ♦ The term i n a 1 i n i t i a 1 i z a t i a n r o u t i n e i s e x e c u t e d o n 1 y 
in response to the Y command and at power up* If you 
have multiple I/O devices you may want to initialize all 
of them in response to any call to the initialization 
routine? or you may want to initialize only the device 
whose number is in the accumulator* If you have this 
r o u t i n e i n i t i a 1 i z e o n I y t h e d e v i c e w h o s e n u m b e r i s i n 
the accumulators' then you will have to remember to issue 
a Y command before us ins* any devices other than 0* The 
10 command will issue a carriage return and line feed to 
the device divert as argument* Thus if you initialize 
only the device whose number is in the A register? the 
first time you stive an 10 command for a non-zero device 
this carriage return and line feed will be passed to the 
character out driver for a device which has not been 
initialized* This will not cause a problem if the 
driver for this device simply loses the carriage return 
and line feed* but you should be careful that it doesn't 
cause an error* You may find it more convenient to 
i n i t i a I i ze a 1 1 de v i ees at one t i me ♦ 



OMAR IN 
PUTS 
OMAR IN 
A 
REGISTER 



5* The panic detect routine should inspect your key- PAN 10 

board for whatever condition you want to use to indicate DETECT 

that a process should be interrupted* This can be a RETURNS 

special character having been pressed v such as control- WITH 

C * or any key h a v i n g b e e n pre s s e d ♦ T h e p a n i c ro u t i n e Z F L A G 

should return with the Z flag on if it determines a ON IF 

panic stop* and with the Z flag off otherwise* The PANIC* 
device number is in the A register* If you have a 

printer and a video terminal* and the printer is a TTY 0THER- 

or Decwriter or the like that has a keyboard of its own WISE OFF 
i n a d d i t i o n t o the k e y b o a r d o n y o u r video t e r m i n a 1 * y o u 

w i 1 1 h a v e to d e c i d e whether to have t h e p a n i c r o u t i n e S M U I... D 

consult the keyboard for the device in the A register* NOT WAIT 

or always consult your terminal keyboard* Note that the FOR 

panic detect routine could also consult a front panel INPUT 
s e n s e s w i t c h if y o u h a v e one* b u t t h i s i s u s u a 1 1 y 1 e s s 
convenient than inspecting the keyboard* 

The panic detect routine MUST NOT WAIT for a key- 
board input* but should simply inspect to see if a panic 
is being requested* For instance* if you have a serial 
terminal being run from an I/O board with a UART* and 
one port serves as a status port* issue an input to the 
status port to see if input is ready* If not return to 
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t h e c a 1 ,1 i n g p r o g r a m w :i. t h t h e Z f 1 a g o f f ♦ I f t h e p r o p e r 
s t a t u s b :i. t :i. n d :i. c a t e s t h e r e i s a n :i. n p u t p r e s e n 1 9 t a k e t, h e 
input if you want to use it to determine whether or not 
to interrupt the process* but your routine should not 
1 o o p i n c a s e t h e r e :i s n p i n p u t p r e s e n t ♦ . 

T h e p a n i o d e t e e t p r o v i d e d i n S Y S 1 w i 1 1 r e s p an d t o 
any key being pressed v if it can detect it* Because 
there are timing considerations involved in sampling the 
:i. n p u t 1 i n e w i t h t h e " s o f t w a r e U A R T " o n t h e B i s k J o a k e y v 
i t •' s b e s t t o r e a u e s t a p a n i c s t o p fo y h i 1 1 i n g t h e b r e a k 
U e y o n y o u r t e r m i n a 1 :i. f i t h a s o n e * s i n c e t h i s t r a n s m i t s 
' s c o i"i t i. n 1. 1 o u s 1 y * 

6 <. 1 1 "i a 1 I. o f t h e t e r m :i, n a 1 I / r o u t i n e s t h e o n 1 y r e g i - 

ster that ne^d be preserved is the stack pointer* I/O 

PROTOCOL. 

If you are using B I SKATE with a North Star Biskv COMPATI- 

the protocol above is compatible with that for the North BLE WITH 

Star DOS I/O routines* though less restrictive* (You NORTH 

d o n ' t h a v e a 1 1 o f t h e i r r e e u i r e m e n t s t o p r e s e r v e t h e S T A R B S 
contents of registers*) Thus for North Star users the 
.jumps in the 10 Jump table can go directly to the North 
S t a r I / v e o t o r s ♦ 

When you go to reassemble 10 if this is necessary v WHEN 10 

you can sfive an I command to the D I SKATE diskette to REASSEM- 

f i n d o u t w h e r e i n t h e m e m o r y A T E a n d 1 w i 1 1 g o * T h e B I... E B I E 

m e in o r y a d d r e s s I i s t e d i n t h e d :i. r e c t o r y p r i n t o u t g i v e s T B I G 

the address j and the size in blocks is also given* If EOR SAME 

A T E f o 1 1 o w s 1 i m m e d i a t e I y i n m e m o r y ? t h e n w o u m u s t b e S P T y 

sure that your reassembly of 10 will not result in a MUST BE 

m o d u I e t o b i g t o f i t * A f t e r a n a «> s e m b I y o f 1 9 t h e R E I... - 

command t OATEB BY 

CHANGING 

TIOEND-SYSIO THE AORG 

w 1 1 1 t e 1 1 y o u h o w b i g 1 i s * I f t h e n u m b e r o f b I o c k s 
n e e d e d t o c o n t a i n i t i s in o r e t h a n t h e n u m h e r I i s t e d i n 
y o u r d i r e c t o r y p r i n t o u t ? \* o u m a y h a v e t o c h a n g e t h e A R G 
statement in SYS 10 and reassemble so that 10 goes some- 
w h e r e e I s e i n m e m o r y * T h i <•> w i 1 1 n o t a f f e c t A T E v s :i. n c e 
ATE picks up the location of 10 taw the Jump at memory 
location 3* 

T h e I / s y s t e m i n D I S K A T E a I s o a 1 1 o w s y o u t o 
customize the drivers for the disk* In most cases you 
would not need to do this? unless B.I SKATE were being 
used with some other kind of hardware* but you might 
want to consider this for certain special applications* 
Eor instance? if you wanted to include on diskettes 
f i I e s w h i c h a o u w o u I d n o t w a n t B I S K A T E t o t o u e h o r e v e n 
k n o w a b o «..i t v t h i s c o u I d b e a c h i e v e d b y r e w r i t i n g t h e 
B I SKATE disk drivers to only begin reading the disk at a 
p a r t i c^ u 1 a r b I o c k ♦ Or? t o i n t e r f a c e B I S K A T E t o s o m e o n e 
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else's operating system» a single very la 
be created for each diskette within this 
system* and then the D I SKATE disk drivers 
direct access reads and writes to this fi 
operating system ♦ So» the protocol for t 
will he given y even though in many cases 
to use it* 

There is one important way in which 
TOMIZE THE DISK DRIVERS* The version sup 
that there actually exists a disk drills f 
p o & s i b I e d i s k d r i v e d e s i .g n a t o r s ♦ Y o u s h o 
Jump table to indicate that a drive is no 
your system!' so that if you try to access 
n o n • - e x i s t e n t drive an error w i 1 1 b e r e t u r 

The format for that part of the Jump 
disk drivers is* 



rge file could 
operating 

could call 
le through the 
h e d i s k d r i vers 
you won ' t need 

YOU MUST CUS- 
plied assumes 
or all of the 
uld alter the? 
t present in 

a file on a 
rued* 

table for the 



Location 



Contents 



I Of .1.5 



10+20 



10+25 



10+30 



10+35 



10+40 



10+45 



10+50 



mu:i: 


C v <eode 


for 


drive 


A 


JMP 


<d river 


for 


drive 


A 


mvi 


Cy<code 


for 


drive 


B 


JMP 


<d river 


for 


drive 


B 


mvi 


C 9 <code 


for 


dvi\/e 


C 


JMP 


<d river 


for 


drive 





MVI 


C 9 <code 


for 


drive 


D 


JMP 


<dri^ev 


for 


drive 


D 


MM I 


Cy<code 


for 


drive 


E 


JMP 


<d river 


for 


drive 


E 


MM I 


C»<code 


for 


drive 


F 


JMP 


<d river 


for 


drive 


F 


MVI 


C ?<code 


for 


dvi\/(s 


G 


JMP 


<d river 


for 


drive 





ST0 










RET 











MUST 
SUBSTI- 
TUTE? 

STO 
RET 

FOR THE 
MM I 
JMP 

FOR EACH 
DRIVE 
THAT 

DOES NOT 
EXIST 



The pair of instructions STCy RET at 10+50 is in 
lieu of a driver for drive H* All of the disk drivers 
return with the carry flag set in case of error* Uhen 
you reassemble SYS I Or then* you should substitute a STCv 
RET for the MVIs» JMP for each drive that does not exist 
in your system* This way any access to drives that 
don't exist will properly signal an error* Be sure that 
when you do this* the name fields are preserved* If you 
are running D I SKATE with only North Star disks 9 then the 
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1 o a d e y* p a r t o f S Y S I m u s t a 1 s o ta e e h a n s* e d s o t h a t a 1 1 o f 
the calls to DRIVE A So to DRIVEE* 

T h e p r o t o e o 1 f o r t h e d :i. s k d r :i. v e r s i s a s f o 1 1 o w s * 

U| h e n t h e d :i. s k d r :i. v e r s a r e o a 1 1 e d * t h e B r e :i. s t e r o a n t a :!. n s 
a code giving the* disk command* The codes are* 

B«3* The disk should be Initialized* This is given 

when a disk is first accessed after power-up? and 
a 1 s o a f t e r a d :i. s k e r r o y % * I f 1 n i 1 1 a 1 1 z a t i o n :i. s i"i o t 
r e o u i r e d v t h 1 s s h o u 1 d s i m p 1 y r e t u r n * 

B " :: 2 1 T h e s 1 z e o f t h e d 1 s k i n h 1 o c k s 1 s t o b e r e t u r n e d 
in BC* For the Disk Jockey this is 1000* (The 
drivers supplied for the Disk Jacket* leave the 
b o o t s t r a p r e o o r d f o r o o n t r o 1 1 e r r o u t i n e s 
i.j n t o u c h e d ♦ T h i s r e c o r d 1 s n o t i n e 1 u d e d i n t h e 1. 
blocks? and as far as DIB KATE is concerned is not 
e v e n t h e re*) F o r t h e N o r t h S t a r d i s k t h :i, s n u m b e r 
is 350* The maximum number of blocks DX SKATE can 
handle is given by the constant MAXBS which is a 
s y iyi b o 1 i n A T E T B I... ♦ ( T h e u s e o f A T E T B I... i s d i s e u s s e d 
i n t h e n e x t s e c 1 1 o n * ) X f t h i s c o m m a n d r e t ur r» s 
w i t h a v a 1 u e 1 a r si e r t h a n M A X B S y a d i s k err o r w i 1 1 
result* Each block is 256 butes Ions? regardless 
o f h o w t h e c o n t r o 1 1 e r p h w s i c a 1 1 *:* o r «E a n i 2 e <•> d i s k 
records* 

B :::: 1 * A r e a d o p e r a t i on* A c o n t a :i. n s t h e n u m b e r o f 

b 1 o c k s " D E c o n t a i n s t h e b e «s i n n i n s m e m o r u ;•» d d y % e s s 
to which the information is to be transfer red v Bnd 
H I... c o n t a i n is t h e b e S i n n i n «( d i s k a d d r e s s 1 n b 1 o c k <•> * 
T h e d i r e o t o r w o c c u p i e s b 1 o c k s • • 3 * T h e d r 1 v e r s 
s u p p 1 i e d f o r t h e Nor t h S t b r D i s k i n v o k e o n 1 w t h e 
North Star DOS routine DC0M and not DL00K* 

B™0* A write operation* The registers A» DE and HI... 

follow the same* convention as for the resd opera- 
tion* 

F o r a 1 1 d i s k c <r> m m a n d s v a r e t u y^ n w 1 1 h t h e e a r r w f 1 a <^ s e t 
is the indication of a disk error* 

If you should want to rewrite the disk drivers for 
w o 1. 1 r o w n a p p 1 1 c a t i o n s 9 a 1 1 D I S K A T E d i s k a d d r e s s i n s{ i s 
relative to your drivers* Thus if your drivers examine 
only a certs in portion of the disk? leaving the re*st 
beyond the reach of DISKATEv D I SKATE'S block n refers to 
the n'th 25 A byte block within the area of disk you've 
set aside* The same would apply for drivers that work 
t h r o u «* h a n o p e r a t i n s s y s t e m ' s d i r e c t a c c e s s f i 1 e 
y % o u t i i"i e s * X n m o s t c a s e s y h o w e v e r r y o u w i 1 1 p r o b a b 1 y n o t 
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need to touch the disk drivers themselves* and the only 
customizing needed as far as the disk is concerned is to 
maintain in the Jump table the proper indication of 
non-existent drives* 

Let's go review now the step~by-step procedure for 
getting D I SKATE running for the first time* 

.1 ♦ Bootstrap in the D I SKATE diskette 9 with a serial 
terminal at 1200 baud connected to the Disk Jockey 
serial port if this is possible* If not? boot anyway 
and wait for the disk to become «uiet* Even if you 
intend to run at 1200 baud from the serial portv you 
s h o u 1 d m a k e a b a c k u p c o p y o f D 1 S K A T E 9 s o y o u w i 1 1 n e e d 
to do some of the steps below* 

2* Put the patches in the Jump table for Jumps to your 
I/O routines if needed* If you want to run from the 
serial port at a slow speed ? patch in the initial baud 
rate constant* The STCr RET for non-existent drives 
can also be patched in if needed* 

3* If you have needed to make patches v force the compu- 
ter to Jump back to the beginning of ID* D I SKATE should 
now respond ♦ 



4* 



single drive 



dual drive 



type* 

GO DSKINT 



Mount a fresh diskette on 
drive B and type* 



Mount a fresh diskette* 



GO DSKINT 



D S K I NT w i 1 1 a s k w h i c h d i s k i s t o be i n i t i a 1 i zed* 



R e m o i. j n t D I S K A T E d i s k e 1 1 e 9 
type ♦ 

L I0TBL <T>yKEEP-0 

6* 

R e m o u n t new d i s k e 1 1 e 9 
type ♦ 

S 10 SYSI0**.T0END 
7* 

Remount D I SKATE d i skette 9 
type ♦ 



type* 

I... I0TBL <T>»KEEP«0 



type * 

S 10 J B SYSX0**I0END 
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I... ATETBL <T>*KEEP™0 

8* 

R e m o i.j n t n © w d :i. s k e t t e » 

S ATE BEGIN* *ENB 

ZKEEP 

S ATETBL <T> 

9 * 

R © iti o i..i n t D 1 8 K A T E d :i. s k © f , t, © v 

I. TOTBL <T>yKEEP^0 
1.0* 

R © m o i.j n t n e w d :i. s k e t t © y 

type* 

ZKEEP 

S " <T> 

1. :l. * 

R © m o u n t D I S K A T E d :i. s k © t t © y 
twp©* 

OjtL. STARTUP 



T ATE ATE IB 

T ATETBL ATETBL SB 



twpe * 



T TOTBL TOTBL JB 



R e m o i.j n t n © w d :i. s k © t 1 © y 
type* 



twpe* 

T STARTUP STARTUP J B 



A t t h :i. s p o :i. n t w o u r n © w d :i. s k © 1 1 © w :i. I 1 h a v © a c o p w o f 
the D I SKATE system in which the patches to the 10 Jump 
t a b 1 © a n d / o r n © w D i s k J o c k © w s © r i a 1 p o r t ta a u d r a t © w :t, 1 1 
have been installed* If sou need to reassemble TO to 
i n c 1 1 j d e w o u r o w n I / r o u t i n e s y c o n t i n u © o n ♦ B © s u r © t o 
change those entries in the Jump table for disk drivers 
so that there is a STCv RET for each non-exi stent drive* 

13, 



M o u n t D I S K A T E d :i. s k e 1 1 e y 



twpe* 
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type * 



0»L SYS 10 



OH... SYS TO 



14* Edit SYS 10 using the D I SKATE editor commands to 
install your I/O routines in place of those there* 
Change the AORG statement to relocate 10 in case your 
I/O routines make 10 large enough to conflict with the 
space occupied by ATE* 

15* Type J Z»A 

If the assembly has errors go back and correct with 
the editor* 

1.A* 



R e m o u n t new d i s k e 1 1 e ? 
type* 

S 10 T" % fl0**<fI0END-SYS10 
S I0TBL <T> 
S SYS10 <F> 



type * 



S I0JB T^f1.0**<fI0END--SYSI0 
S I0TBL*B <T> 
S SYSI0JB <F> 



N o t e t h a t t h i s p r o c e d u r e d o e s n o t n e c e s s a r i I y c a 1 I 
f o r y o u t o transfer ever y f i 1 e t o t h e n e w d i s k ♦ T h e 
rest a re d i sc ret i ona r y ♦ It's ve r y i mpo r t an 1 9 though » 
that whenever you reassemble 10 you also save the symbol 
table as the file I0TBL * 
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II 42 Personalizing D I SKATE Settings 



When D I SKATE is brought upy many D I SKATE variables 
w :i. 1 1 a 1 r e a d w h a v e b e e n si i v e n v a I u e s * B e e a u s e t h e s e 
v a 1 u e s s e r v e t o a 1 1 o e a t e t h e m e m o r y y y o u m a y w i s h t o 
o h a n «t e t h e :i. r p o w e r - u p s e t t :i. n & s * I n w o r k :i. n «S w :i. t h t h e 
a s s e m b I e r y f o r :i. n s t a n e e » m e m o r y m u s t b e a 1 1 o e a t e d f o r 
the source area? the symbol table? and the area of 
memory into which the object code is to be placed* 
T h e s e m a y r e « u :i. r e d i f f e r e n t a m o u n t s o f a r e a d e p e i"i d i n «* o n 
t h e t y p e o f J o b * F o r c o iti p 1 e x p r o <•? r a m s t h e s y m b o I t a b 1 e 
a r e a w i 1 1 h a v e t o b e « « ,.i :i. t e 1 a r <$ e v p e r h a p s u p w a r d s o f 
s e v e r a 1 K ■» n t h e o t h e r h a n d y w h e n e d i t :i. n <•* s o u r o e f i 1 e s 
where there is no Question of assembly!' the only 
r e « u :i. r em e n t f o r a s y m b o 1 t a b 1 e i s t o h o 1 d v a r :i a b 1 e s t o 
b e u s e d :i. n c o m m a n d s a n d iti a c r a s y s o t h a t a s y m b o I t a b 1 e 
of only 512 bytes or less may suffice 4 D I SKATE provides 
two ways that your own choice of values at power -up time 
o a i "i b e e s t a b I i s h e d •> a n d b o t h o f t h e iti a r e b o t h s i m p 1 e a n d 
systematic * 

The easiest way to estab 
to include commands for them 
Suppose you want the memory a - 
as follows* 



:i.sh your own settings it 
in the STARTUP file 4 
t p <^ w e y u p t o b e a 1 !l o o a t e d 



3200H * * 4 :l. FFH Swmfoo 1 Tab 1 e 
4200H * 4 6FFFH Sou rce A r ea 
7000H4 4 7FFFH Object Code Area 

T h e s e s e 1 1 i n r-i s c a n b e a c h 1 e v e d b y t h e f o 1 1 o w i n «^ c o m -• 
mands* 

' n 3200HyM<T> 

04200H 

»7000Hy$8 

I n o rd&fr f o r t h e s e c o m m a n d s t o b e e y, e c u t e d a u t o m a t i c a 1 1 y 

at power upj all you have to do is make sure they bvb 

i ri c 1 u d e d 1 n t h e S T A R T U P f i 1 e 4 T h 1 s f i 1 e e a n a 1 s o 
include such commands as INTE or PROSy Q or J? TABv UlIDy 
a n d s o f o r t h 4 S i ri c e S T A R T U P i «> a s o u r c e f i I e :i. t i s e a s y 
to change J Just type 0*L STARTUP and then edit it like 
any other source file* then type S " <F> when hou sr& 

finished 4 When STARTUP is executed at power up time* it 

may be anywhere on the disk 4 The advantssEe of concen™ 
t v a t i ri «? y o u r p e r s o n a 1 1 z a t i o n i n t h e s t a r t u p f i 1 e i s t h a t 
:i. t '' s e a s y t o c h a n «iS e y a n d y o u c a n i n i t i a 1 i s e « o u r s y s t e m 
easily by typing OyGO STARTUP 4 Because STARTUP will 
m o s t 1 i k e 1 y b <•? a v e r y s m a 1 1 f :i. I e y y o u m a y f i n d :i. t e o n - 
venient to include a copy on each diskette 4 

I n s o m o? i n s t a n c e s t h i s m a y b e 1 n c o n v e n :i. e n t y o r 



CAN 

PERSON- 
ALIZE 
BY 

SETTING 
UALUES 
IN 

STARTUP 
FTI...F 



COMMAND 
FOR <S>y 
%v $ FOR 
OBJECT 
CODE y 
'"'adr y 
M<T> 
FOR <T>y 
ETC* 



CAN 
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won't even work at all* For instance ? if you want a PERSON- 

driv® other than A to be the default drive at power up? ALIZE 

this cannot be done with a CD command in the STARTUP BY 

filer since at power-up DISKATE will get STARTUP from MAKING 

the default drive ? which unless you change it will be A* SETTINGS 

The other method for personalizing values is to set them THEN 

however you would like? and then save ATE on the disk SAM TNG 

with these values bavins! been established* Whenever you ATE 
do this YOU MUST MAKE CERTAIN ATE WILL BE THE SECOND 

E N T R YIN T H E D I R E C T R Y * 1 h e r w i s e t h e I o a d e r i n 1 w i 1 1 T H E N A T 

load the wrong file* If you save a new copy of ATE? any POWER -UP 

commands, you have given which change internal settings ? ALL 

such as CD* INTE? and the like* will result in D I SKATE SETTINGS 

being brought up at power up in Just the state in which WILL BE 

it was saved? unless settings are changed by the STARTUP AS THEY 

file or the power -up initial command string 0?Z?Y* Thus WERE AT 

for instance!* if you move the source area and the symbol THE TIME 

table? then save a new copy of ATE? afterwards at power™ ATE WAS 

up the source are a and symbol table will begin at the SAVED 

same places they did at the time ATE was saved? but the EXCEPT 

symbol table will contain only the initial assembler AS 

variables and the source area will be empty* CHANGED 

To aid in this process you can use the symbols BY 

conta i ned i n ATETBL * ATETBL i s a f i I e on the D I SKATE ? Z ? Y 

diskette which gives an abbreviated version of the actu™ OR 

al symbol table from an assembly of your version of ATE* STARTUP 
F o r t h e m o d u I e 1 ? of c o u r s e ? t h e e n t i r e s o u r c e c o d e i s 
given* ATETBL includes a large number of addresses 
which are important for use in machine language pro- 
grams? which will be discussed in the next section* A 
listing of the meaning of the symbols in ATETBL is given 
a t t h e e n d o f P a r t 1 1 1 * I n t h i s s e c t i o n t w o s y m b o I s 
concern us particularly* BEGIN and END* The interval 
B E G I N ♦ ♦ E N D ? w h e r e B E G I N a n d E N D a r e s y m b o I s f r o m A T E T B L ? 
is the interval in memory occupied by the code for the 
module ATE* Thus to save a new copy of ATE? here is the 

procedure* PROCE- 
DURE FOR 

1* Give the command L ATETBL <T>?KEEP^0* This will SAVING 

establish ATETBL as the symbol table? with KEEP at NEW COPY 

the &nd* OF ATE 

2* Change whatever settings you want to personalize* 

3* Give the command S ATE BEGIN* *END SHOULD 

ALLOCATE 

Remember? again? that if the copy of ATE is being ere- <T> BIG 

a ted on a new diskette? ATE must be the second directory ENOUGH 

entry* Also? you should be sure that the power -up ver- TO HOLD 

s i o n o f A T E y o u c r e a t e a 1 1 oca t e s e n o u g h m e m o r y i n t h e A T E T B L 

symbol table to hold ATETBL* You can find the size of AT LEAST 
ATETBL by giving an I command for a diskette containing 



D I S K A T E U s e r ' s M a n u a 1 



1.08' 



i t » A T E T B I... i. s n o t p a y % t i c u 1 a r 1 w 1 a y* si e s» s o t h :i. s s h o u .1. d b e 
no problem* Don't make? the mistake* though y of think ins! 
wou don't need anw space at all for the symbol table 
even if won want to pre^sr^ a version on 1m for editing 
prose tewt* 

If won want to make a copy of DT SKATE on a new 
d i s k e 1 1 e w i t h n e w s e 1 1 i n <•* s ? y o u e a n f o 1 1. a w t h e s a m e t y p e 
o f p y* o o e d u r e a 1 r e a d y sf :i. v e n t o iyi a k e a ta a e k u p o f D I S K A T E 
w h e n y o u f :i. r % s t <•* e t u p a n d r i, j n n :i. n s * R a t h e r t h a n r e v i e w - 
:i. n <•* a 1. 1 o f t h e cj e t a :i. 1 s o f t h :i. s p r o c e d u re a «* a :i. n s> t h e r e 
are a few important points to note* The mi mm urn steps 
needed to create a new coph of 01 SKATE srwt 

1. * T h e i "i e w d :i. s k e 1 1 e m u s lv b e i n i t i a 1 :i. % e d * 

'?♦ A copy of 10 must be saved a«i the first entry in the 
d i r e c t o r y * ( T h i ?r> i a n o t n e o e «> s a r y i f y o u y* <n y s t e m 
w i 1 1 ta e b o o t s t r a p p e d f r o m a N o y % t h S t a y> D i s k * ) 



'x 



A copy of ATE must be saved as the second entry in 
the directory* 



4* A copy of STARTUP must be saved* 

Whenever you reassemble 10 you should also update TO TBI,, 
so that TO TBI... is the symbol table for an assembly of the 
same code as 10* In this way? 10 can be saved by set-- 
tins* the symbol table to TOTBI... and typing* 

8 10 SYS10**10END 

Likewise y ATE c®n be <saved by setting the symbol table 
to ATETBL Bnd typing* 



S BE01N* .END 
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1 1 ♦ 3 I n t e r f a e i n g D I S K A T E t o Mac h :i. n e I... a n si u a «M e P r o g r a m s 



DISK ATE" provides no less than three different 
methods for interfacing machine land u age programs* They 
c a n e i t h e r b e c a 1 1 e d f r o m D I S K A T E * or the y c a n c a 1 1 
D 1 8 K A T E a n d e x e c u t e i t a s a s u b r o u t i n e ♦ We' 1 1 d i s c u s s 
these in order* The easiest method of .invoking a 
machine language program is with the X command* which 
w e ' v e a 1 r e a d y d i s c u s s e d ♦ W r i t i n g a p r o g r a m t o b e 
i n v o k e d i n t h i s w a y g i v e s g r e a t f 1 e x i b i 1 i t y s i n c e t h e 
p r o g r a m n e e d n o t a c t u a 1 1 y b e r e s i d e n t i n m e m o r y a t t h e 

time it is invoked it can Just as well be invoked by 

a GO command* Of course* when wou issue a GO command to 
a iti a c hi i n e 1 a n g u a g e p r o g r a m y y o u m u s t b e s u r e i t w i 1 1 n o t 

v e r 1 a y a p a r t o f t h e m e m o r y n e e d e d f o r s o m e t h i n g e 1 s e ♦ 
I n t h i s s e c t i o n we' 1 1 d e s c r i b e h o w s u e h a p r o g r a m c a n 

h a v e access t o D I S KATE i n f o r m a t i o n ♦ 

There av^ 3 subroutines within DISK ATE whose CALL 

addresses ar& given in ATE TBI.,, that can be used in a MCHK 

1 i n k a g e p r o c e d u re w h e r e b y t h e s a m e k i n d o f i n t e r v a 1 

arguments used by D I SKATE commands can be passed to a TO SEE 
machine language program* The structure of the process IE ARG 
i s t his* t h e m a c h i n e 1 a n g u a g e p r o g r a m c a 1 1 s a s u b r o u - P R 1:1! S E N T 
tine within D I SKATE to determine if an argument is 
p r e s e n t ♦ I f s o v a n o t h e r s u b r o u t i n e c a n be c a 1 1 e d t o Z E L A (3 
e v a I u a t e i t ♦ T h e e a s i e s t w a y t o 1 i n k t h e s o i..i r c e c o d e o f (3 E E I E 
your machine languasae program to the addresses of these THERE IS 
subroutines within D I SKATE is to set the symbol table to AN ARG 
ATE TBI... before assembling your program by the same proce- 
dure we saw in the last section* The routine to be GET A DDR 
. e a 1 led to s e e i f a n a r g u m e n t i s p r e s e n t i s e a 1 1 e d V C H K ♦ F V H K 
It returns with the Z flag OFF if an argument is v»v®~ FROM 
s e n t v o t h e r w i s e t fy e Z f I a g :i. s o n * T h i s a 1 1 o w s w r i t i n g a A T E T B L 
program Which takes special action in the default case 
o f n o a r g u m e n t * 

I f a n a r .g u m e n t i s p r e s e n t y o u c a n c a 1 1 t h e s u b r o u - C A L L 

tine called OVALS to evaluate it* It is important that DUALS TO 

a blank separate the argument and the address of the EVALUATE 

s u b r o u t i n e i n t h e c a s e o f a n X c o m m a n d ? o r t h e f i 1 e n a m e A R G •• — 

i n t h e c a s e o f a G c o m m a n d * C V A I... S w i 1 1 r e t u r n w i t h t h e R E T URN S 

lower address of the argument in MLv and the upper LOWER 

address in DE» unless an error occurs* In this case ADDR IN 

CVALS WILL NOT RETURN AT ALL but will exit by Jumping to HL* 

the same error exit used by D I SKATE commands which have UPPER IN 

an error* This exit routine is called WHAT and its DE 

a d d r e s s i s a 1 so ^ive n i n ATE T B L ♦ Y o u c o u Id trap a 1 1 J U M P S T 

DISKATE errors by patching at the location of WHAT* WHAT 

though this is not recommended except for experienced IF ERROR 
programmers* 

What if you want to evaluate an argument and have VALUS 

control passed back to your machine language program in WILL 
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case of an error? In this case you can call UAL US in- EVALUATE 

stead of OVALS* This routine works like OVALS s> but will ARO % 

return with the Z flag OFF if there is an error in RETURN? 

evaluating the argument* There is one important other "I FLAG 

d i f fere n c e ♦ Y o u m u s t s u p p 1 y t o V A L U S t h e a d d r e s s e s o f F F I F 

t h e i n i t i a 1 r e f e r e n c e :j. n t e r v a 1 y o »..i r s e 1 f y t h e 1 o w e r F R R R * 

address in HI... and the upper address in BE* Note that MUST 

this can be used to have the machine language program RIVE 

determine the initial reference interval and the argu- IN IT RFF 

ment within it passed from the terminal or a macro* You INTERVAL 

"don't need to supply the initial reference interval if IN HI. BE 
y o 1 1 c & n b e o e r t a i. n t h a t a n a r g «. 1 iyi e n t w i 1 1 ri o t c o n t a i. n a n y 

matching symbols? but this is risky since if the argu- ARGS 

ment contained matching symbols by mistake you could get MUST BE 

u n i. n t e n d e d res u 1 1 s * P R F C F B E B 

Y o u c a n h a v e in u 1 t :i. p 1 e a r g u m e n t s •> a s 1 o n g a s t h e y B Y B L A N K 
are separated by blanks* To evaluate further arguments 
Just call CVALS or VALUS repeatedly* 

Suppose you wanted a machine language program to GET 

f o 1 1 o w t h e s a in e p r o t o c o 1 a s B I S K A T E c o m m a n d s a n d u s e t h e A B D R S F 

last interval computed in case the argument is missing* B I SKATE 

How do you obtain this interval? Such information as INTERNAL 

this CBn be obtained by read-in*?.* the contents of the REG I- 

relevant internal D I SKATE registers* Atfain this is done STERS 

b y u s :i. n g s y m b o 1 s f r o m A T E T B I... * I n t h i s p a r t i e u 1 a r e « a m - F R (!) M 

pie? the lower address of the last interval computed is ATE TBI. 
stored at the address denoted by the symbol PI? and the 

upper address at P2* If you take a minute to skim F*G* 

through the listing of the meaning of the symbols in < AT PI 

ATE TBI... at the end of Part IIIv you will see that you > AT P7 
h a v e c o m p 1 e t e a c e e s s t o a 1 1 o f t h e i. n f o r m a t i o n a v a i I a b I e 

t o B I S K A T E c o m m a n d s ♦ T h e s o u r c e a r e a i s t h e i n t e r v a 1 < S > A T 

from the contents of BOSAP to the contents of EOSAP* and BOSAP v 

t h e c u r r e n t f i. 1 e i s t h e i. n t e r v a I f r o m t h e c o n t e n t s o f F D S A P 
B (!) F P t o t h e c o n t e n t s o f E F P 9 f o v i n s t a n c e ♦ Y o i. \ w i. 1 1 

need such information to supply an initial reference <F> AT 

i n t e r v a 1 i f y o u c a 1 1 V A L U S * N o t e t h a t r e a d i n g t h e B F P s> 

contents of internal B I SKATE locations in this way is a FOFP 
second method of passing information from B I SKATE to a 
machine language subroutine* If you use this method be 
careful to avoid mistaking an address like BOSAP v which 
is the address WHERE THE LOWER ABBRESS of the source 
bvbb IS STORE Bv for the contents of the 16 bit area 
beginning at this address* 

A s e c o n d in e t h o d o f i n v o k i n g a m a o h i n e 1 a n g 1 1 a g e 
program from BISK ATE is by using a special feature which 
we haven't discussed before t the USER COMMANB TABLE* 

To execute a machine language program by the method USER 

above you have to give a command in the form X 3ddr* or COMMANB 

G f i I e n a m e v o p t :i. o n a 1 1 s-.t f o 1 1 o w e d b w a n a r g u m e ri t * B y T A B L E 
u s i ri g t h e u s e r e o m m a n d t a b I e y o u c a n :i. n v o k e a e o m m a n d 

precisely as if it were a B I SKATE command* When .DIJ3KATE SAME 
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i s p o w e r e d u p * it co n t a A n s a t a b 1 e w h :i. c h :i. t e a n s u 1 1 s F R M A T 
whenever a command is given* The format of this table AS 
is identical to the format of the gumbo 1 table* which SYMBOL 
we've already seen* However * the symbols in this table TABLE 
are not labels or variables? but ar^ the names of 

commands created by the user* The "values" for these SCANNED 
symbols are the addresses of the machine language BEFORE 
programs which are to perform the given commands* TABLE OF 
Whenever a command is given* DI SKATE first scans this BUILT-IN 
user command table to see if there is a command with COMMANDS 
that name* If so* it calls the program whose address 
f o 1 1 o w s t h e s y m b o 1 for t h e c o m m a n d i n t h e u s e r c o m m a n d L I S T S 
table* If not? it scans the internal D I SKATE command COMMAND 
table* Hence if you have any user defined commands* NAME 
t h e i r n a m e s w i 1 1 h a v e p r i o r i t y o v e r t h e D I S K A T E b u i 1 1 - i n T H E N 
commands* For instance* if you had a user -defined ADDR OF , 
command called PRINT* the command PRINT would invoke PROGRAM 
your command instead of invoking the D I SKATE P command TO PER- 
and assuming RINT is a variable name* FORM IT* 

When the version supplied of til SKATE is brought lip* AT THE 
s small amount of space within the code for the module END 
ATE is allocated for a user command table* and the user 
com m a n d t a b 1 e w i 1 1 b e i n t h i s s p a c e u n 1 e s s y o u m a k e a S P A C E 
new copy of D I SKATE with the user command table WITHIN 

somewhere else* Of course* to start with there ar^f no ATE FOR 
user -defined commands* so the initial contents of this IT AT 
s p a c e i s a i n d i c a t i n g t h e e n d o f t h e u s e r c o m m a n d U S R T * * 
table* This space consists of the interval ROMEND 

USRCT* ♦ ROMEND* where USRCT and ROMEND sr^ symbols from 
ATE TBI...* Let's see an example of how to create a user 
defined command* In Part I we gave a functional but 
inelegant program called PRNTSYM to print out the symbol 
table* Suppose we want to make this into a user defined 
c o m m a n d * w h i c h t o a b b rev i a t e w e ' 1 1 c a 1 1 P S Y M ♦ Re c a 1 1 
that PRNTSYM was assembled to begin at 7F00H* and that 
to assemble PRNTSYM r-ror-'&rl^ we had to set the symbol 
table to ATETBL to get addresses for OUT* PHI... SB* and 
SYMTB* Let's suppose that we've Just assembled PRNTSYM* 
that the source code for it is the current file* and 
that the symbol table has not been zeroed* Let's also 
assume that there are no user defined commands at this 
point* To create the user command table* we can <-ii^& 
the following commands* 



N 

EC ORG USRCT 

ASC PSYM~ 

DW PRNTSYM 

DB 

1 

A 
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(Remember that FRNTSYM sets the assembler format to 

Intel*) This simple source program will create a user CAN SAME' 

command table with only one entry* PSYM* Now any time NEW COPY 

we want to print out the symbol table we can give the OF ATE 

c o m m a n d P S Y M a s i f i t w e r e a b u i 1 1 •••• i n D I S K A T E e o mm and* W 1 TH 

However* for this to become permanent there are two USER 

things that must be done immediately* First* we have to COMMA ND 

save a new copy of the module ATEv so that when D I SKATE TABLE TO 

i s b r o u g h t u p t h e n e w u s e r co m m a n d t a b 1 e w i 1 1 b e i n H A U E I N 

p 1 a c e * S i n c e t h e s y m b o 1 s f o r A T E T B I... a r e a 1 r e a d y i n t h e P L A C E A T 

s y iyi b o 1 t a b 1 e * we o a n d o t h i s b y m o u n t i n g a d i s k e 1 1 e w :i. t hi P W E R •••• I J P 
A T E oJ s t h e s e c o n d d i r e c t o r y e n t r y a n d t y p i n g * 

S ATE BEGIN** END 

Since the user command table is located within the space 

f o r t h e m o d u 1 e A T E * w h e n D X S K A T E i s b r o u g h t u p f r o m t h :i. s 

v e r s i o i"i * o u r u s e r c o m m a n d t a b 1 e w i 1 1 b e t h e r e * T h e C M M A N T'l 

second thing that must be done is to include? the com- TO LOAD 

mandJ CODE FOR 

EXE- 

I... PRNTSYM CUT I NO 

USER 

i n t h e S T A R T U P f i 1 e » f o r o t h e r w i s e t h e c o d e f o r t h e u s e y* M MAN D 

o o m m a n d P S Y M w i 1 1 n o t b e i i "i t h e m e m o r y a t p o w e r •••• u p * a n d 8 1 -I (!) U I... D 

giving the command PSYM would probable cause a crash* GO IN 

In <3eneral there are three thirds to keep in mind STARTUP 

w h e n y o u c r e a t e a n e w u s e r d e f i n e d c o m m a n d i F 1 1. E 

1. * The co do? for the new part, of the user command table 
must be ADDED ON TO THE END of anu code that you already 
have for a user command table* so that existing user 
defined commands are not lost* Thus you should always 
keep on disk a copy of the file which assembles the user 
command table* 

2 * A f t e r , a s s e m b I y o f a n e w u s e r c o m m a n d t a b 1 e y o u h a v e 
to re save ATE* 

3* You must make sure you have provided a way at power - 
u p t i m e f o r t h e o b , j e c t c o d e f o r t h e r o u t i n e w h i c h w i 1 1 
carry out the user defined command to be brought into 
the memory* The easiest way is to include the proper I... 
c o m iti a n d i n t h e S T A R T U P f :i. 1 e * 

T h e t h :i. r d m e t h o d o f i n t e r f a c i n «={ a iyi a c> hi i i"i e 1 a n *^ u a <S e 
p r o «s r a m t o D I S K A T E h a s a c o m p I e t e I y d i f f e r e n t s t r u c t u t % e * 
It is possible for D I SKATE to serve as a subroutine to 

b e c a 1 1 e d b y a m a c h i n e 1 a n s u a 3 e p t x o £ r a m * T h e m a o hi i n e M A C H I N E 

language pro.gram can pass a strinst of commands for LANGUAGE 

D I S K A T E t o e x e c* u t e * a n d :i. f t h e s e e o m m a n d s i n c I u d e a n A T E P R 05 R A M S 

command* further commands v^art be entered from the CAN CALL 

terminal Just as if D I SKATE were being executed from the D I SKATE 
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power -up state* To use this method you must NOT call 
the entry point ATE? since this will initialize the 
stack and lose the return address* Rather* you call a 
special entry point called ATECOMS* This entry point 
assumes that the HI... register pair contains the beginning 
address of a string of D I SKATE commands* It will 
e x e c u t e t h e s t r i n g y t h e n r e t u r n b a c k t o t h e c a 1 1 i n g 
program* If the command string results in an error* the 
e r r o r m e s s a g e w i 1 1 b e p r i n t e d o n t h e t e r m i r« a I b u t c o n -* 
trol will still return to the calling program* The one 
thing you must be careful of is that the command string 
cannot include a RENT command? nor should this be given 
from the keyboard during an invokation of D I SKATE called 
h y a m a o h :i. n e I a n g u a g e p r o g r a m ? s i n c e i t w i 1 1 r e s u 1 1 i n 
t h e r e t u r n a d d r e s s b e i n g 1 o s t * 

To make it easier to use this feature? when D I SKATE 
is powered up a Jump to ATECOMS is written at memory 
location 0* Thus D I SKATE can be called by a machine 

1 a n g u a g e p r o g r a in b y t h e f o 1 1 o w i n g p r o c e d u r e t 

;l. * I... o a d H I... w i t h t h e a d d r e s s o f a s t r i n g o f D I S K A T E 
commands ending with a 0* The string can include sever- 
a 1 c o m m a n d 1 i n e s * 

2 * E x e e u t e t h e i n s t r u c t i o n R S T * D I S K A T E w i 1 1 b e 
called and will execute the command string* Note that 
it will be using the stack of the machine language 
program that called it* 1.00 bytes of stack should be 
s u f f i c i e n t f o r mo s t a p p 1 i c a t i o n s * 



MIA 
ENTRY 
POINT 
ATECOMS 

EXECUTES 
COMMAND 
STRING 
WHOSE 
A DDR 



•ccj 



IS 
HL 



IN 



JUMP TO 

ATECOMS 

WRITTEN 

AT 

MEMORY 

LOCATION 

CAN 

BE IN- 
VOKED BY 
RST 

RETURNS 
WITH 
CARRY 
SET IF 
ERROR 



3* When control is passed back to the machine language 
p r o g ram* the c a r r y f I a g w i 1 1 h a v e be e n s e t i f a n e r r o r 
has occurred v so your ^raf-iram can check for this case* 

Because of the Jump to ATECOMS at memory location 0» the 
RST will automatically cause a call to be vectored to 
ATECOMS* 

One way for your machine language program to Pass 
information to D I SKATE using this method is to set the 
value of internal D I SKATE variables* For instance? sup- 
p o s e y o u w a n t to genera t e a s o u r c e f i 1 e u s i n g a m a c h i n e 
language program and then operate on it with D I SKATE 
commands* The contents of BOFP and EOFP can be set to 
point to the beginning and ending of the file* with the 
contents of BOSAP and EOSAP being set to point to a at 
the beginning and a at the &nd of the file* Then when 
you call D I SKATE the current file will be the file 
g e n e r a t e d b y y o u r m a c h i n e I a n g u a g e p r o g r a m ♦ 

Information can be passed from D I SKATE to a machine 
language program with this method using a special com- 
mand which we haven't seen before* The V command v V for 
evaluate? will put the lower address of the argument in 



V 
COMMAND 
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HI... s\"\d the upper address in. DE* This command will not 
achieve anything if given from within D I SKATE itself? 
since the information in HI... and DE will be overwritten 
by subsequent internal routines* However y if the V com- 
mand is the .'last command in a string of commands execu- 
ted by ATECOMS y on returning to the caller HI... and DE 
will ha\/B the addresses of the argument* For instance^ 
suppose you wanted the value of the D I SKATE variable X* 
The machine language source statements* 



I. XI Hy COMMAND 
RST 



ABEL 



COMMAND ASC MX 
DB 



PUTS 
LOUER 
A DDR OF 
ARC IN 
HLv. 

UPPER IN 
DE 

ONLY OF 
USE IN 
COMMAND 
STRING 
TO DE 
EXECUTED 
BY 
ATECOMS 



as part of a machine language program would cause the 
value of X to be in both HI... and DE after the return to 
t h e s t a t e m e n t I... A B E I... « 

The commands in a command string executed by 
ATECOMS can certainly include disk commands* You can 
even use this method to link to the value of symbols in 
ATETBL during the execution of a machine language pro-" 
gramy rather than during assembly? by having a command 
string include L ATETBL <T>yKEEP" :: Oy or the like? and 
then a v" command for a symbol in ATETBL* With this 
f 1 e x i b i 1 1 1 y y v i r t u a 1 1 y a n y t y p e o f 1 n t e r f a c e n e e d e d 
between D I SKATE and a machine language program can be 
constructed* 

If a machine language program needs access to the 
information in the directory regarding a disk fi ley it 
can be obtained by consulting the D I SKATE disk buffer* 
This buffer begins at the address DISKBUFy where DISKBUF 
is again a symbol from ATETBL* After an I command y a 
c o p y of t h o? e n t i r e d 1 r e e t o r y w i 1 1 o c c u p y 1 2 4 b y t e s 

beginning with DISKBUF* (DISK ATE consults the disk 

resident copy of the directory for any disk commands 

this copy of the directory is left in memory only for 
use by user programs*) A machine language program can 
consult the directory by statements such as* 



COPY OF 
DIREC- 
TORY 
LEFT AT 
1ST 1024 
BYTES OF 
DISKBUF 
AFTER I 
COMMAND 



LXI 
RST 



D I ROOM 



DIRCOM ASC* L#ATETBL*<T> y 
ASC KEEP-Oyly 
ASC MDISKBUF 
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DB 







Upon returning to the machine language program after the 



RST Qv HI... will point to a copy of the directory 



The 



program can page through it entry by entry? testing the 
f i r s t 8 b y t e s o f e a c h 1 6 fo y t e e n t r « f o r t h e d e s i r e d f i 1 e 
namey then reading from memory the desired information* 

N o t e t h a t y o u e a n a 1 s o c o n s u 1 1 t h e d i r e e t o r y 
d i r e c 1 1 y f r o m D I SKA T E * F o r :i. n s t a n c e » t o g e t a c o r e d u m p 
of the directory type* 

L. ATE TBI... <T> 
KEEP^O 



#ti:i:SKBUF«*<f 1.023 
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P a r t 1 1 1 * S y s t © m R e f © r © n c © $5 u m m a r y 



S p © c :i. a 1 i n p u t o h a r a c t e r s ♦ 



I!" B C o a us© s c u r r © n t I :i. n © t o b © :i. n «* n o t % © d m \ echoed* E S C o a i..i s © s 
© s e a p © f r o m t h © p a n :i. e s t a t, © ♦ 

B A C K S P A C I::! o a u s © s J u s t - 1 y p © d c h a r a c t © r t o h © :i. tf n o r © d * B a c k s p a o e v 
s p a c © v b a c k s p a c © i s e e h o © d * 

8 :i.n th© panic state causes one character to be printed artd the 
p a n :i. c s t a t e r © in a :i, n s :i. n © f f e c t » 



Panic State* 



A panic detect routine whose addr©ss is «*iv©n by the .Jump at 10+1.2 
:i. s c a 1 1 e d p © r i o d i c a 1 1 y y i. n c 1 u d :i. n si p r i o r t o t h e o u t p u t o f © a o h 
characters to determine if a process is to be interrupted* Th© 
rout in© provided will cause a process to be interrupted if ana key 
is pressed* provided it can be detected* The Break key $ives the 

m o s t e a s i 1 y d © t e e t e d s i *3 n a 1 ♦ A u s e y p r o v i d © d p a n i o d e t e o t e s t a b •• 

1 :i. s h e <•> :i. t s o w n e o n d i t i o n s f o r d e t © r m :i. n i n <=i w h © n a p r o c e s s i s t o b e 
interrupted* If the process is to be interrupted s» the panic state 
is entered* The panic state is also entered when a PAUSE command 
i s e x e c u t e d o r $ i s e n c o u n t e r e d a s t h e f i 1 e n a in e i n a f i 1 © n a m e 
1 i s t f o r a s s © m b I © r e o m m a n d s * 



W h e n t h e p a n i c s t a t e :i, s e n t e r e d y t h e s w s t e m w :i. 1 1 w a i t f o r <•» n 
input* If this input is the character S» the process continues 
b Li t t h e p a n :i. c s t a t e i «i a u t o m a t i c <;j 1 1 w s t :i. 1 1 :i. i"« e f f e c t t h e n e j< t t i m e 
t h e p a n i c d e t e c t r o u t :i. n e i s t o b e c o n s u 1 1 e d * T h u s S w i 1 1 a 1 1 o w 
o n e c h a r a c t e r t o b e o u t p u t d u r i n <$ I i s t i n sE s ♦ I f t h e c h a r a c t e r 
input is ESCv the process is aborted* If th© character is ana- 
thiruS other than S or ESC the process resumes with the panic state 
n o I o n 5.1 e r i n e f f e e t * 



C o m m a n d F o r m a t ♦ 



Blanks allowed anywhere EXCEPT WITHIN AN ARGUMENT* A blank is 

m a n d a to r « t o s e p a r a t e m u 1 1 i p I e a r $ u m e n t s o f o n © c o m m a n d ♦ M u 1 1 i p I © 

commands separated by commas may he given on a single line* 
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A simple number is sliven by a string of dibits or hexadecimal 
digits beginning with a decimal digit v fr&cBded by a minus sign 
f o r n e g a t i v e n u m bers» a n d s u f f i x e d i m m e d i a t e 1 y b w * 

no suffix decimal 

octal 

H hexadecimal 

A number can be given in the SPLIT FORM alb where a and h ar& 
simple numbers* a-tb denotes 256* a + b* Numbers denote 1.6 bit 
v a 1 u e s * N e g a t i v e n u m b e r s a r e r e p r e s e n t e d i n t w o ' s c o m p 1 e 1 e in e n t 
form as signed 15 bit integers* Addresses are .1.6 bit non-negative 
integers* When a negative number is treated as an address the 
s i g n b i t w i 1 1 b e t r e a t e d a s a d i g i t b i t ♦ 



Variables* 



A variable name may be ans-.i lengthy must contain only upper case 
letters and digits and must begin with a digit* Variables denote 
16 bit values* 



A r i t h m e t i c pera t i o n s * 



The arithmetic operations f » -* Jfc» / are performed left to right 
with the same priority* # is modulo 65536? and / gives only the 
« u o t i e n t d i s c a r d i n g t h e r e m a i n d e r ♦ 



A r i t h m e t i o E x p r e s s i o rj s ♦ 



V a r i a b 1 e s a n d n u m b e r s m a y c o m b i n e d i n t o a n a r i t h m e t i c e x p t^ e «> s i o n 
u s i ri g t h e a r i t h m e 1 1 c o p e r a t i o n <•> ♦ F : ' a r e n t h e s e s a r e n (3 1 a 1 1 o w e d * 



Intervals* 



A n i n t e r v a 1 i s a p a 1 r o f a d d r e s s e s 9 w i t h t h e f i r «•> t a d d r e s s < »~ t h e 
second address* It specifies the interval in the computer's 
memory from the lower address to the upper address inclusive* A 
single number is identified with an interval whose lower and upper 
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a d d r e s s e s a r e era u a 1 * 



I n i t :l. a 1 R e f e r e n c © I n t e r v a I * 



The initial reference interval is determined by* 

1. ♦ The commands and 

2* The 3 r humeri t of the last REEF command if one has been given* 

The initial reference interval for Dm Gy and F commands is the 
source area* For all others the initial reference interval is 
t h e c u r r e n t f i 1 e i f n o R E F c o m m a n d w a s g i v e n o r t h e a r g u m e n t o f 
the last REF command was empty* otherwise the initial reference 
:i. n t e r v a 1 i s t h e a r g u m e n t o f t h e 1 a s t R E F o o m m a n d g i v e n a s a p p 1 i e d 
t o t h e c u r r e n t f :i. 1 e * 



M a t c h i n g 1* n t e r v a 1 8 y m h o 1 s * 



I" text.*.! matches the first occurrence of text within the initial 

r e f e r e n c e i n t e r v a 1 * t e x t iti a w c o n t a :i. n a n y A S C 1 1 e h a r a e t e r s 
i n c 1 i..i d i i"i g n o n •'•• p r i n t i. n si c o n t r o 1 c h a r a c t e r s * 

* s e « u e i"i c e o f n u m b e r s s e p a r a t e d b w b 1 a i "i k s # 

matches the first occurrence in the initial reference 
interval of the sequence of bytes whose codes ir\ the 
current base are given by the numbers* The numbers 
must be positive* O 255 and should NOT have a Q or H 
base suffix* 

m a t c h e s t h e f i r s t c a r r i a & e r e t i..i r n i n t h e i n :i. t i a 1 r o? f e r e n c e 
interval 

$ m a t c h e s t h e f i r «i t c h a r a c t e t^ i n t h e i n i t :i. a 1 r e f e r e n c e 
interval 

* m a t c h e s a n y t h i n s-i i n t h e i n i t i a 1 refer® n c e i n t e r v a 1 * (A n w 
n u m b e r o f c o n s e <:^ u t i v e d o t s c a n b e u s e d * ) 



N o n •••• M a t c h i i"« «f I n t e r v a 1 S y m b o 1 s 



<exp> an arithmetic expression specifies the address given bw 
the value of the expression* Expressions are treated as 
n o n •••• n e «E a t i v e 1 6 b i t n u iti b e r s ♦ 
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< F > d © n o t e s t h e c u rren t f i 1 © ♦ S © © ta © 1 o w u n d © r M © m o r y F :i. 1 © s ♦ 

•v S > d © n o t © s t h © s o u r e © a r © a * S © © h © I o w u n d © r M © m o r y F i .1. © s ♦ 

<T> denotes the symbol table* See below under Symbol Table* 

<R> denotes the last record read from disk* See below under 
D :i. s k F :i. 1 e R e f e r e n c e S y m b o 1 s ♦ 

S' % denotes the address next after the end of the source area 

)' % denotes the address next after the &nd of the $ umbo I table 

d © n o t e s t h e a d d r e s s £ :i. v © n b y t h e e n t r y p o :i. n t e r ♦ T h © o h a r • •• 
a c t © r w h o s e a d d r e s s :i, s t h e v a 1 u © o f " :i. s c a 1 1 e d t h © t a r <3 © t 
character* The value, of ~ As «S:i. vosn by the 16 bit number 
s t o r e d a t C H P T R w h e r e C M P T R i s a s y m b o 1 f r o m A T E T B I... * 

< denotes the lower address of the last interval computed* 
This is assigned a value as soon the lower address is 

d e t © r m i n e d » e v e n i f t h e u p p e r a d d r e s s h a s n o t y e t b © © n 
determined* The value of < is given by the 16 bit number 
stored at PI where PI is a symbol from ATE TBI... * 

> denotes the upper address of the last interval computed* 
Assigned a value when the complete argument is evaluated 
or ! is encountered* The value of > is sslven by a 1.6 bit 
number s to rod at P2 where P2 is a symbol from ATETBL* 

? denotes the address of the last error in a macro or com- 
mand lin©? or the point at which printout from a " command 
was aborted via vanic: detect* The value of ? is the 16 
bit number stored at ERSAU where ERBAv 1 is a symbol from 
ATETBL* 

X denotes the assembler program counter* The value of & is 
the 16 bit number stored at AS PC? a symbol from ATETBL* 

* denotes the assembler storage counter* The value of $ is 
the 16 bit number stored at STCTR* a symbol from ATETBL* 

< e x p > ! where < © x p > i s a n u m e r i c a 1 e x p r e s s i o n y d e n o t e s t h e e x p ' t h 

line in the current file* ©xp is interpreted as a positive 
1 6 b i t n u m b © r 9 a n d i f t h i s i s 1 a r «3 e r t h a n t h e n u m b e r o f 
lines in the file <exp> ! denotes the at the &nd of the 
file* ! without <©xp> and 0! ar© the same as 1 ! ♦ 



I n t e r v a 1 A r si u m e n t s * 
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An Interval Argument maw be specified taw a Matching Interval Sym- 
ta o X 9 a N o n - M a t c h i n g I n t e r v a X S w m b o X y o r a n e w p r e s s i o n i n w h i o h 
interval symtaols are combined by* 



X n t e r v a 1 p e r a t i o n s * 



C o n c a t e i"i a t i o n J D e n o t e d b y o n e i n t e r v a 1 s w m b o 1 i m m © d i a t e X w 

f o 1 X o w e d b w a n o t h e r « N e :i. t h e r :i. n t e r v a 1 s y m b o 1 s m a y o o n t a i n 
a n w i"i o n - m a t e h i n g i n t e r v a 1 s w m b o 1 s ♦ X* h e i n t e r v a 1 d e n o t e d 
is the interval matching the concatenation of the patterns 
specified taw the two interval symbols* 

A r i t h m e t i e p e r a t i o n s * I h e s w m ta o 1 < 1 1 > < o p > < 1 2 > y w h e r e < X 1 > a n d 

<I2> are interval symbols and <op> is an arithmetic opera- 
tion has lower address :: » < lower address of XX XopXXower 
address of X2>y upper address « <upper address of 
IXXopXXower address of X2>» 



% 



The symbol <X>% where <X> is an interval symbol eMPands 
t h e u p p e r e n d o f t h e i n t e r v a 1 t o a n e n t :i. r e 1 i n e 



Occu r renc in g* The symboX <exp><I> where <exp> is an arithmetic 
expression and <I> is an interval symbol containing no 
non-match ins symbols denotes the exp'th occur renpe of 
the pattern given by <!>♦ <exp> is interpreted as a 
signed 15 bit number* If the value of <exp> is negativey 

< e x p > < I > d e n o t e s t h e A B B ( e ;•; p ) ' t h o c c u r r e n c e o f t h e 
pattern given by <X> counting backwards from the end of 
t h e i ri i t i a X r e f e r e n o e :i. n t e r v a 1 * 

♦ Any number of consecutive dots can be used* <X:I.>*<12> 

denotes the interval from the taeginning of XX to the ^nd 
o f 1 2 ♦ If < 1 2 > c o n t a i n s o n X y m a t c h i n g s y m ta o X s y t h e y 
m a t c h t h e f i r s t o c c u r r e n e e o f t h e p a 1 1 e r n g i v e r - i w h i c h 
occurs AFTER II ♦ If the end of 12 is lower than XX an 
e r r o r a n d a in a t c h i n g f a i X u re w i X X o c c u vv e v e n i f < 1 1 > a n d 

< 1 2 > o o n t a i n n o m a t c h i n g s s-.t m ta o 1 s ♦ 

! < I X > ! < 1 2 > o a u s e s t ta e i n i t i a X v e f e r e n c e i n t e r v a X f o r a 1 1 
matching swmtaols in <I2> to tae the interval denoted taw 
<Il>y and as soon as ! is encountered > is given the value 
of the upper address of IX* 



Order of Priority of Interval Operations* 



X C o n c a t e n a t i o n 

2 A r i t h m e t icy % y o e c u r r e n o :i. n g 

3 



ighest 
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4 



Lowest 



D e f a u 1 1 I n t e r v a 1 A r *3 u m e n t * 

For anw command except disk commands which take an Interval Arslu- 

m e n t w'h e r e n o a r & u m e n t i s ?•* i v e n v t h e a r <•* u m e n t u s e d w i 1 1 b e t h e 
last interval, computed* 



D i s k F :i. .1. e R e f e r e n c e S y m b o I s *. 



Disk Drive Designator* 

a letter A through H* A through D denote Disk .Jockey 

D rive s :l. t h r o u <:i h 4 v E . t h y* o u <3 h G d e n o t e N o r t h S t a r D y* :i. v e s 

t h r o u «* h 3 « H i s e u r r e n 1 1 y u n u s e d ♦ 



D i s k F i I e N a m e s * 

A n y s e « u e n c e o f u p t o 8 A 8 1 1 e h a r a o t e y % s w h o s e v a 1 u e i s 
<•* r e a t e r t h a n h e x 2 ( a b I a n k ) e x c e p t f o r J 

1 ♦ » 

2* * 

3 * (? a s t h e f i r s t e h a r a c t e v o f t h e f i. 1 e n a iyi e 

4+ • " as the first character of the file name 

p t i o n a 1 1 \f f o 1 1 o w e d i m m e d i a t e 1 w ( n o i i "i t e r ve n i n «? b I a n k ) b v* 
J t h e n a D i s k D r i v e D e s i <3 n a t cj r ♦ !f f i "i o D i s k D r i v e D e s i <•$ •••• 
n a t o r i s p r e s e n t i t :i. s a s s u m e d t h e f i 1 e r e s i d e s o n t h e 
Current Drive ♦ 

1 n p I a c e o f a f i I e n a m e s> t h e s y m b o I M d e n o t e s t h e m o s t 
r e c e n 1 1 '■■a r e f ere n c e d f i I e * I f a f i I e n a in e i s p r e f i x e d 

i m m e d i a t e 1 y ( n o * i. n t e r v/ e n i n 5.1 b I a n k ) b w t h e c h a r a e t e r $ y 
a d i. s k c o m m a n d r e f e r e n c i n <:i t h :i. s f i 1 e w i 1 1 f i r s t (•? x e o u t e 
a PAUSE command 3m:i then execute the disk command ♦ 

<R> denotes the interval in the memory occupied by the 
m o s t r e c e n 1 1 y r e a d r e e o r d f r o m t h e d :i. s k * T h e I o w e r 
address of <R> is sfiven by the 16 bit value stored at 
RECAD and the upper address by the 16 bit value stored at 
RECND* where RECAD and RECND are symbols from ATETBL* 



Memory Files* 

F i 1 e s i n t he memory a r e 1 o e a t e d w i t h i ft a n a r e a c a 1 1 e d t h e 
source area? denoted by <S>* The lower address of <S> is 
sfiven by the 1.6 bit value stored at BO SAP and the upper 
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address 'by the .1.6 bit value stored at EOSAPy where BOSAP 
and EOSAP sv® symbols from ATETBL ♦ S' n deontes the same 
value as 1 + the contents of EOSAP* Each file is a 
seauence of bytes bounded by O's* One such file is the 
e u rren t f i 1 e y d e n o t e d b y < F > * T h e lower a d d r e s s o f < F > 
is sive'n by the 16 bit value stored at BOFP and the upper 
address by the 16 bit value stored at EOFP» where BOFP and 
EOFP are symbols from ATETBL* <F> does not include its 
bounding O's* <S> includes the giving the lower bound 
o f t h e 1 o w e s t f i 1 e a n d t h e g i v i n g t h e u p p e r b o u n d o f t h e 
highest file* 



Symbol Table* 

The symbol table is denoted by <T>* The lower address of 
<T> is given by the .1.6 bit value? stored at SYMTB» and the 
upper address by the 16 bit value stored at TABA» where 
SYMTB and TAB A are symbols from ATETBL* Each entry in the 
symbol table consists of the characters of the symbol with 
t h e 1 a s t o h a r a c t e r h a v i n g i t s his* h o r d e r b i t s e t y f o 1 1 o w e d 
by the 1.6 bit value of the symbol* A occurs at the end 
of the table* The symbol table includes both variables 
and assembler labels* When a value is assigned to a 
s y m b o 1 y the s y m b o 1 t a b 1 e i s s e a r c h e d u n t i 1 t h e t e r m i n a 1 
regardless of the value of TAB A? and if the symbol is 
undefined it is added to the end of the table ar\d TAB A 
updated* T~ denotes the same value as 1 + the contents of 
TAB A* On power -up and after the "I command the symbol table 
c o n t a i n s v a 1 u e s f or t h e f o 1 1 o w i n g s y m b o 1 s u s e d b y t h e 
assembler* 

Av By C» By Ey Hy b My SPf PSU 

C o m m a n d S u m m a r y ♦ 

" < I r« t e r v a 1 A r g u m e n t > ( " Q u o t e i n t e r v a 1 " ) 

Prints on the terminal the characters contained in the 
i n t e r v a 1 g :i. v e n a s a r g «..i m e n t » w i t h a 1 i n e f e e d i s s u e d 
a u t o m a t i c a 1 1 y a t e a c h c a r r 1 a g e r e t u r n * 



* < n o a v g u m e n t > ( " Q u o t e o n e 1 i n e M ) 

P r i n t s o n the t e r m :i. n a 1 t h e 1 i n e c o n t a i n i n g t h e t a r g e t 

character? with the character ~ immediato?ly preceding 
the target character* 



E < E n t r y A r g u m e n t > where ( M E n t e r " ) 
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an Entry Argument is a seouence of Matching Symbols of 

the form I" text. "I or tseouence of numbers* or .,.. as defined 

above* In this ease text maw extend across any number 
of lines* 

If the entry pointer is within the source area y the ohay 

aeters denoted by the argument are inserted into the our™ 
r e n t f i I e b e t w e e n t h e t a r g e t e h a r a c t e r a n d t h e p r e c e d i n «* 
c h a r a o t e r y e x p a n d :i. i"i g b o t h t h e c u r y % e n t f i I e a n d t h e s o u r c e 
area? otherwise they overwrite those characters ir> the 
m e iti o r y b e g :i. n n i n <:i w i t h t h e t a r g (? t c h a r a c t e y % ♦ I n e i t h e r 
ease the target character after the command is the charac- 
ter after the material entered by the E command* 



K < I n t e r v a I A r g u m e n t > 



("Kill" ) 



K i 1 1 s t h e i n t e r v a I g i v e n a s a y* $ u m e n t ♦ I f t h e :i. n t e r v a I i s 
w i t h i n t h e s o u r o e a r e a y t h e i n t e r v a I i s d e I e t e d f y % o m t h e 
f i 1 e i. i "i w h i o h i t o c e u r s a n d iri o v e d t o t h e a y % e a o f m e m o r y 
i m m e d i a t e I y f o 1 1 o w i n g t h e s o u r c e a r e a b y a n i n t e r n a 1 M 
command* The deleted text is not surrounded by O's* 
Immediately after a K command the Default Interval Argu- 
m e n t w i 1 1 b e t h e i n t e r v a I o c o u p i e d b y t h e d e 1 e t e d t e x t 

u t s i d e t h e s o u r c e a y v e a * T h e t a y v «* e t c h a y* a c t e y v w i X I b e t h e 
f i r s t e h a r a c t e r :i. n t h e s o u r c e f i 1 e a f t e y v t h & m a t e v i a I t h a t 
was deleted* 

1 f t h e i n t e r v a I i s n o t w i t h i n t h e s o u r c e a r&a? t h e i n t e r •••• 
v a 1 i <r> z e r o e d a i"« d t h e t a r «t e t c h a r a e t e y* b e c o m e s t h e f :i. y % s t 
c h a r a c t e r i n t h e i n t e r v a I ♦ 



M < I n t e r v a 1 A r sf u m o? n t > 



( "Hove" ) 



Moves the interval sfiven as argument to the address sfiven 
by the entry pointer* If the? entry pointer is within the 
s o u v c e a r e a v t h e n t h e i n t e r v a I i s i n s e r t e d i n t o t h e f i I e 
c o n t a i n i n «* t h e e n t r y p o :i. n t e r h e t w e e n iv h e t a r «* e t c h a y^ a c t e y^ 
and the precs»din«S charact&r^ Otherwise the characters of 
the interval are copied to overwrite the area of memory 
beginning with the target character* The target character 
becomes the character after the new location of the last 
character moved* Internal pointers to the following are 
updated by the M command* 



.:-C 



.<:>.••• y 



<F>y <R> 



<T> 



r 



y (and hence the default 



i n t e r v a 1 a r g u m e i "i t ) y U ser C o m m a i"i d T a b I e y M a c r o C o m m a n d 
I ri t e r p r e t a t i o n P o i n t e r y R e t i.j r i"i A d r e s s e s y F\' e p e a t A d d r e s s e s * 
A pointer is updated if the address it gives is within the 
interval given by the argument before the move takes 
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place* There is a pointer for both the lower and upper 
address for &ach of <S>* <F>» <R>* and <T>y and if only 
one such pointer lies within the argument because the 
argument overlaps * only the one pointer will be updated* 
This maw cause ar\ erroneous value* 



< I n t e r v a 1 A r g u m e n t > ( " s e t E n t r y P o i n t e r " ) 

The entry pointer is set to the lower address of the 
argument* 



< X i "i t e r v a 1 A r <•* u m e n t > ( ■ C o p y " ) 

The characters of the interval are copied to the avea of 
m e iti o r y ta e g i n n i n g w i t h t h e t a r g e t c h a r a o t e r * N o p o i n t e r s 
are updated and the action of the command is not affeetd 
by w h e t h e r t h e e n t r y p o :i. n t e r i s w i t h :i. n t h e s o u r c e a r e a ♦ 



B < A v i t h e m e t i c E x p r e s s i o n > ( " B a s e " ) 

The low order byte of the value of the express ion becomes 
the current base* It may be an^i number > 4* For bases > 
10? ASCII characters in order beginning with A are used 
for dibits* Numbers ar& printed in split form for all 
bases other than 1.6* 



# < I n t e r v a 1 A r 3 u m e n t > < M Q u o t e n u m b e r s ( c o r e d u m p ) " ) 

The numerical value in the current base for the bytes of 
the interval are printed on the termina.lv with the address 
of the first byte of a line printed at the left of the 
line* 



? < I n t e r v a 1 A r 3 u m e n t > ( " W h e r e ? " ) 

Prints on the terminal in the current base the upper snd 
lower address of the interval given as argument* 



? " Prints on the terminal the file name including disk drive 
designator for the most recently referenced file* 



N ( no argument ) ( " No? w f i I e " ) 

Creates a new empty source file at the (-nmd of the source 
area and makes it current* The target character becomes 
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th© at the end of this file* 

REF IX Interval Argument string up to 24 char act ers>.'.l 

( "Reference interval " > 

The string in brackets is saved in a special location* 
For all subsequent commands which take <F> as the initial 
reference interval the Interval Argument sliven bw this 
string is evaluated and bo? comes the initial reference 
i n t &r\/B t * C o m m a n d s t a k :i. n g < S > a s t h e i n i t i a 1 r c f e r e n c e 
i n t e r v a I a r e u n a f f e c t e d ♦ 

ref i::::i 

1.1 i s c o i "i t i n u e u s e o f t h © R E F f e a t u re* 

REF (no argument) 

Print on the terminal the last string saved as the argu- 
ment for a REF command* 

D E F C < o o m m a n d s t r i n g u p t o 2 4 c hi a r a c t e r s > 1 < " D e f a u 1 1 c o m m a n d " ) 

The string in brackets is saved in a special location* 
Subsequently whenever a command is expected Bnd a carriage 
ret u r n o n I w i s t y p e d w i t h a n e m p t y c o m m a n d I i n e v t h e 
s t r i n g s a v e d w i 1 1 b e e ;•* e c u t e d a s a d e f a u 1 1 c o m m a i "i d * 

def i:::i 

Discontinue use of the DEF feature 

DEF (no argument) 

Print on the terminal the last string saved as the argu- 
ment for a DEF command* 



I n t e r v a 1 A r g u m e n t > ( " F i I e " ) 

Establishes as the current file the file containing the 
lower address of the interval given as argument* If this 
address contains this becomes the lower bounding 
o f t h e f i lev o t h e r w i s e t h e 1 o w e r b o u n d i n g i s t h e f i r s t 
backward in the memory from this address* The upper 
b o u n d i n g i s t h e f i r s t i n t h e m e m o r w f o r w a r d f r o m t h e 
lower bounding 0* The entrv* pointer is set to the upper 
bounding 0* If either bounding is within the source 
sreB9 the source bvb is expanded if necessary to include 
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th© new file* If the new file .is entirely outside the 
source area the source area consists on 1m of the new file 
and its bounding O's* The initial reference interval is 
<S> regardless of any REF commands* 



< I n t e r v a 1 A r g u m e n t > ( M r :i. g :i. n a t e s o u r e e a r e a " ) 

T h e i n t e y n v a 1 g i v e n a s a r g u m e n t i s e s t a b 1 i s h e d a s t h e 
source area* If the lower address of the interval and the 
upper address are the same* an emptw source ar&a consist- 
ing only of two consecutive zeros is created at the 
address* Otherwise the forming the lower bound of the 
source area is written at the lower address of the inter- 
val and the upper bound is written at the upper address* 
T h e h i g h e s t ( p o s s i b 1 y e m p t y ) f i I e i n t h e n e w so u r c e a r e a 
is made current and the target character becomes the at 
the end of this file and hence also at the end of the 
source area* 

(no argument) 

An empty source area is created at the beginning of the 
current source area* 



D < I n t e r v a 1 A r g u m e n t > ( M D o " ) 

The string of commands located at the lower address of the 
interval given as argument is executed* Execution of this 
s t r i n g i s t e r m i n a t e d b y e i t h e r a n e n d o f t h e f i 1 e ( a ) o r 
a QS or QF command* When execution terminates control is 
passed back to whatever command string invoked the D eom- 

m a n d ♦ A n a I o <-i o u s t o s u b r o u t i n e c a 1 1 ♦ T h e i n i t i a I r e f e y 

ence interval is the source area regardless of any REF 
commands* 



G < I n t e r v a I A r <$ u m e n t > ( " G o t o " ) 

Execution of commands is transferred to the lower address 
of the interval given as argument* There is no return to 
the command string invoking the G command* Analagous to a 
GOTO command* The initial reference interval is the 
source area regardless of any REF commands* 



R < I n t e r v a 1 A r $ u m e n t > < "Repeat" ) 

The rest of t h e c o m m a n d I i n e o r f i 1 e i n w h i c h t h e c o m m a n d 
occurs is repeated the number of times given by the lower 
a d dress of t h e a r g u m e n t ? w h i c h i s u s u a 1 1 y a n a r i t h m e t i e 
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expression* The value of the lower address of the argu- 
ment is treated as a 16 bit non-negative integer* If the 
argument is the remainder of the command string contain- 
ing the R command is not executed* Execution of an R loop 
maw he terminated bw a QS or QF command* R loops maw .be 
nested* If the command string containing the R command is 
to issue a return on completion? the return is issued 
after the repetition has been terminated* 



>fc < s t r i n g > w h ere ( * c o m m e n t " ) 

t h e s t r i n g o o n t a i n s n o c o m m a s v b I a n k s v o a r r :i. a g e r e t u r n s v 
a r e n d o f f i 1 e c h a r a e t e r s ( ' s ) * 

A 1 1 char a c t e r s f r o m t h e * u p t o t h e n e x t c o m m a v h I a n k v 
csrr i a g e re t u r n o r e n d o f f i I e a r e i g n o r e d a 1 1 o w :i. n g t h e 
s t r i n g t o s e r v e a s a I a b e I ♦ 



Q F < I n t e r v a I A r g u m e n t > < ■ Q u i t o n F a i I u r e " ) 

Execution of a command string invoked by a D command s» or 
repetition invoked bw an R command!' is terminated and a 
return if pending is executed provided the argument 
res u 1 1 s i n a n A r g u m e n t I"' a i I u rev w h e r e a n A r g u m e n t F a i I u r e 
is caused bw either the failure to obtain a match for a 
matching argument » or bw an interval which results in the 
lower address being greater than the upper address* If an 
Argument Failure does not occur execution continues* Onlw 
t h e i n n e r m o s t p r o c e s s i s t e r m i n a t e d * A n A r g u m e n t F a i I u r e 
does not result in an error condition* 



Q S < I n t e r v a 1 A r g u m e n t > ( " Q u i t o n S u c c e s s ■ ) 

Execution of a command string invoked bw a D commands or 
repetition invoked bw an R command » is terminated and a 
return if pending is executed unless the argument results 
i n an A r g u m e n t F a i 1 u re? where a n A r g u m e n t F a i I u r e i s 
d e f i n e d a s a b o v e ♦ I f a n a r g u m e n t f a i I u r e o c o u r s e x e c u t i o n 
continues* Onlw the innermost process is terminated* An 
A r g u m e n t F a i 1 u r e d o e s n o t r e s u 1 1 i n a n e r r o r c o n d i t i o n * 



X < I n t e r v a I A r g »..i m e n t > ( " E x e c u t e " ) 



The machine language subroutine at the lower address of 
t h e i n t e r v a I g i v e n a s a r g u m e n t :i. s c a 1 1 e d ♦ I f i t m a i n t a i n s 
the integritw of the stack it maw end with a RET statement 
and execution Of the process which invoked the X command 
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will continue* 



', v a r i 8 b 1 e > » < I n t e r v a 1 A r g u m e n t > 

The lower address of the argument is .assigned to be the 
value of the variable* If the variable :i. s not present in 
the symbol table it is entered there as described above 
u n d e r S y m b o 1 T a b I e ♦ There m u s t n o t b e a b I a n k b e t w e e n t h e 
variable name snd the « sign* 



M C < p r a m p t s t r i n g > "I ( M A c c e p t o m m a n d " ) 

The strinsf within brackets given as argument is printed on 
t h e t e r it« i n a 1 a s a p r o m p t ♦ n e o o m m a n d w i 1 1 b e a c o e p t e d 
and executed and then the process invoking the COM command 
w i 1 1 c o n t i n u e ♦ T h e c o m m a n d m a w b e a m u 1 1 i - 1 i n e E c a m m a n d y 
o r a m u 1 1 i p 1 e e o m m a n d c o m m a n d 1 i n e ♦ T h e c o m m a n d I i n e 
typed in response to the COM command maw be ESC'ed b\u:\ 
retyped* An error in the command will cause the process 
invoking the COM command to terminate and issue an error 
condition* 



A T E T < p r o in p t s t r i n g > 1 ( " :i. n v o k e D I S K A T E r e e u r s :i. v e I w " ) 

The string within brackets given as argument is printed on 
the terminal as a prompt* D I SKATE calls itself recursively* 
a n d then w i 11 a c c e p t a n d e x e c u t e a n y n u m b e r of c o m m a n d s ♦ 
An error condition terminates only those processes invoked 
by commands given after the ATE command is executed* Exe-~ 
c u t i o n o f D I S K A T E c o n t i n u e s i n t h :i. s s t a t e u n t i I t h e B Y E 
command is given y at which time execution of the process 
t h a t i n v o k e d t h e A T E c o m m a n d c o n t i n u e s ♦ 



B Y E (no a r g u m e n t ) ("by e - b ye* r e t u r n t a t o D I S K A T E c a 1 1 e r " ) 

D I SKATE returns to its caller* If it was called internal- 
ly by an ATE command y the process invoking the ATE command 
r e s i..i m e s ♦ I f i t was o a 1 1 e d b y a m a c h i n e 1 a n g u a g e p r o g r a m y 
execution of that program resumes* If D I SKATE was invoked 
o n 1 y b y the p o w e r •••• u p p ro c e d u r e y the BY E c o m in a n d w i 1 1 c a u s e 
D I SKATE to be reloaded from the disk* 



R E N T ( n o a r g u m e n t ) ( " R e e n t e r " ) 

D I SKATE is reentered at the "ground Il^vel" at the same 
entry point given by RENT where RENT is a symbol in 
ATETBL ♦ The stack is reinitialized but all other varia- 
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bles and pointers ar® left intact* All processes active 
at the time the RENT command is given ar^ terminated? 
including processes invoking ATE commands* If a machine 
1 a n g u age program h a s e a 1 1 e d D I S K A T E * t h e R E NT c o m m a n d w i 1 1 
cause the return address to be lost* 



Y ( n o a r g u m e n t ) < " W i p e " ) 

C a 1 1 s t h e t e r m i n a 1 i n i t i a 1 i z a t i o n r o u t i n e ♦ T h e v e c t o r t o 
this routine is located in the vector table which begins 
the module ID? at 10+9* On power- -up this routine is 
c a 1 1 e d b w a n i n t e r n a 1 Y c o m m a n d * 



W 1 D < a r i t h m e t i c e x p r e s s i o n > ( " t e r m :i. n a 1 W i d t h " ) 

The width for the terminal is set to the low order bvrte of 
the value of the argument* If the terminal produces a new 
1 i n e a u t o m a t i c a 1 1 y o n 1 i n e o v e r f 1 o w 9 a w i d t h e « u a 1 t o t h e 
hardware term i n a 1 w i d t h w i 1 1 p r o d u e e a n e x t r a b 1 a n k 1 i n e 
for lines whose length is exactly the terminal width* 

W 1* D ( n o a r «3 u m e n t ) 

P r i n t s t he c u r r e n t t e r m i n a 1 w i d t h o n t h e t e r m i n a 1 ♦ 

PAUSE (no argument) 

The message PAUSE is printed on the terminal and the panic 
state is entered* 

1 < a r i t h m e t i c e x p r e s s i o n > ( " s e t X / d e v i c e n u m b e r " ) 

The low order hwte of the value of the arithmetic expres- 
s i o n i s s u b s e « u e n 1 1 w s u p p 1 i e d i n t h e A re g i s t e r a s a n I / 
d e v i c e n u iyi b e r t o a 1 1 e a 1 1 s t o t h e t e r m i n a 1 1 / r o u t i n e s + 
A carriage return and line feed are printed on the device* 

I... < f i 1 e n a m e > < I n t e r v a 1 A r g u m e n t > ( " L o a d d i s k f i 1 e " ) 

The file is loaded at the lower address of the interval 
g i v e n a s t h e s e c o n d a r g u m e n t * T h e D e f a u 1 1 I n t e r v a 1 A r g i..i - 
merit maw not be used as the Interval Argument* 

I... < f i 1 e n a m e > < n o I n t e r v a 1 A r g u m e n t ) 

If the file is not a source file it is loaded at the 

a d d r e s s give n b w t h e m e m o r w a d d r e s s po r t i o n o f t h e d i r e c t • - 
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ory* If the file is a source file it is loaded at the 
address given by the entry pointer ♦ If the entry pointer 
i s w i t h i n t h e s o u r c e srear t h e f i 1 e i s i n s e r t e d i n t o t h e 
m e m o r y f i 1 e c o n t a i n i n g t h e t a r g e t c h a r a c t e r fo e t w e e n t h e 
target character and the preceding character? with any 
bounding 0's removed* In this case the target character 
becomes the character in the source area after the last 
character of the disk file* 



S < t i 1 e n a m e > < I n t e r v a I A r g u m e n t > < " S a v e d i s k f i 1 e ■ ) 

The interval given as the second argument is saved as a 
d i s k f i 1 e w h o s e n a in e i s t h e f i r s t a r g u m o? n t ♦ I f a f :i. .1 e 
with this name already exists* it is replaced by the con- 
tents of the interval* If no file exists with this name 
i t i s c r e a t e d ♦ I f e n o «..i g h r o o m f o r t h e f i I e e x i s t s o ri t h e 
disk b u t n o t i n o n e c o n t i g u o u s b I o c k t h e d i s k w i 1 1 b e c o m • 
pacted and the message COMPACTING ON DRIVE (drive desi gna- 
t or) w i 1 1 b e p r i n t e d o n t h e t e r m i n a I * I f t h e i n t e r v a I i s 
w i t ft i n t h e s o u r c e a y* e a t h e f i I e t y p e i s s e t a t ( s o u r c e 
f i 1 e ) 9 o t h e r w i s e t ft e f i 1 e t y p e i s s e t a t 1 * 7 ft e m e m o r y 
a d d r e s s p o r t i o n o f t h e d i r e c t o r y w i 1 1 c o n t a i n t ft e 1 o w e r 
address of the interval i-iiven as the second argument* If 
the d i s k o r d i r e c t o r y i s f u 1 1 » a n e r r o r m e s s a g e t o t h a t 
e f f e c t w i 1 1 r e s u 1 1 a n d t he c o n t e n t s o f t h e d i s k w i 1 1 b e 
unchanged ♦ 



GO <filename> 

T h e d i s k f :i. 1 e whose n a m e i s t h e a r g «..i m e n t i s 1 o a d e d a n d 
e x e c u t e d v v i a a n i n t e r n a 1 c o m m a n d i f i t i s a s o u r c e f i I e 
or via an internal X command otherwise* Equivalent to I... 
< f i I e n a m e > •> D < R > f or so u r c e f i I e s o r I... < f :i. I e n a m e > * X < R > f o r 
n o n ••- s o i..i r c e f i I e s ♦ The s a m e c o n v e n t i o n s f or 1 o a d i n $ t h e 
f i 1 e t h a t a p p 1 y t o t h e I... c o m m a n d a p p I y t o t ft e G c o m m a n d ♦ 



I < o p t i o n a 1 D :i. s k D r i v e D e s i g n a t o r > < M I d e n t i f w " ) 

T h e d i r e e t o r y o n t h e d i s k 6r i v e g i v e n a s a r g u m e n t i s I i s t - 

ed* If no argument is given the directory on the current 

drive is listed* A copy of the directory is left at the 

1.024 bytes beginning at OISKBUFv where DISKBUF is a symbol 
in ATETBL* 



F S < o p t i o n a I D i s k D r :i. v e D e s i g n a t o r > ( "Free S p ace") 

The amount of free space on the disk and on the directory 
for the drive given as argument is listed* If no argument 
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1.31. 



is sliven the listing is for the current drive* 



U <f ilename> 



( "Unsave" ) 



T h e d :i. s k f :i. 1 e w h o s e n a m e :i. s t h e a r g u m e n t i s d e 1 e t e d f r a m 
the directory* 



T < s o u r c e f :i. 1 e n a m e > < d e s t :j. n a t :i. o n f i 1 e n a m e > 



("Transfer" ) 



T h e c o n t e n t s a n d d i r e c t o r y a 1 1 r :i. b u t e s o f t h e d i s k f i 1 e 
w h o s e n a m e :i. s t h e f :i. r s t a r g u m e n t a r e t r a n s f e r r © d t o t h e 
file whose name is the second argument* If there is no 
file whose name is the second argument it is created* 
with compacting occurring as with the S command* 



TO <souree Disk Drive Designators- <dest:i. nation Disk Drive Des:i.g*> 

< " T r a i"i s f e r D i s k " ) 

E a c h f i 1 e o n t h e d i s k d e s i g n a t e d h y t h e f i r s t a r «a u m e n t i s 
transferred to the disk designated by the second argument 
w i t h t h e s a me c o n v e n t i o n s a s f o r t h e T c o m m a n d * F i 1 e s o n 
the destination disk drive whose names are not in the 
directory on the source disk drive are unaffected* If the 
d e s t i n a t i o n d i s k d r i v e o r d i r e c t o r y d o e s n o t h a v e e n o u g h 
room t o c o m p 1 e t e t h e t r a n s f e r f o r ever y f i I e o n t h e s o u r c e 
disk drive 9 the transfer will be carried out for each file 
for w h i c h t here i s r o o m a n d t h e n a n err o r m e s s a g e w i 1 1 
o c c u r i n d i c a t i n «{ t h a t t h e d i s k o r d i r e c t o r y i s f u 1 1 ♦ 



R N < c u r r e n t f i 1 e n a m e > < n e w f :i. I e n a m e > 



( " Rename " ) 



T h e f i I e w h o s e n a m e i s g i v e n b y t h e f i r s t a r g u m e n t i s 
renamed to the name ^iven as the second argument* If the 
second argument includes a Disk Drive Designator it is 
ignored* 



W < f i I e n a m e > < I n t e r v a I A r g u m e n t > 



< " W r :i. t e m e m o r y a d d r e s s " ) 



The lower address of the interval given as the second 
argument is written in the memory address portion of the 
directory for the file name given as the first argument* 



C D < D i s k D r i v e D e s i g h a t o r > ("C u r r e n t D v i v e " ) 

The d i s k d r i v e d e s i g n a t e d b w t h e a r g u m e n t i s e s t a b 1 i s h e d 
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as the current drive* 



A <Iist of file names separated by blanks> ("Assemble") 

Invokes both passes of the assembler to assemble the 
s o u r e e p ro<Sr a m 1 o g i c a 1 1 y e e u :i. v a 1 e n t t o t h e c o n c a t e n a t :i. o n 
of the files given in the argument list* @ maw be 
included as a file name to cause a PAUSE command to be 
executed while diskettes btb changed* The name of each 
f i 1 e i n t h e 1 i s t i s p r :i. n t e d o n t h e t e r m i n a 1 a s i t i s 
assembled bw each pass* The source area is not affected* 



A (no argument) 

Invokes both passes of the assembler to assosmble the cur- 
rent file* (I*e* <F>*) 



A :l. < I i s t o f f i I e n a m e s > ( " A s s e m b I e r P a s s 1 " ) 
A:l. (no argument) 

Identical to the A command but invokes only Pass 1 of the 
assembler* T h e s w m b o 1 t a b I e i s c o m p i I e d b u t n o o b J e c t 
code is generated* 



A 2 <list of file names> 
A2 (no argument) 

Identical to the A command but invokes only Pass 2 of the 
assembler* 



Q ( n o Bvsi u m e n t ) ( " Q u i e t " ) 

Assembler listings are suppressed exeept for assembler 
error messages > until the next J command is encountered* 



V J (no argument) ("Jabber") 

The a s s e m b I e r w i 1 1 r e s u me pv i n t i n g I i s t i n g s ♦ 

% < Interval A r g u m e n t > ( " s e t a s s e m b 1 e r p r o $ r am c o u n t (•? r " ) 

The assembler program counter is assigned the value of the 
lower address of the interval given as argument* 
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$ < I n t e r v a 1 Ar«( u m e n t > Cse t a s s e m b .1. er s t o r a si e o o u n t e r " ) 

The assembler storasle counter is assigned the value of the 
1 o w e r sd d ress o f t h e :l. n t e r v a 1 & i v e n a s a r si u nr« e n t ♦ 

Z ( n o a r si u m e n t ) ( ■ 7. e r o t h e S w m b o 1 T a b 1 e ■ ) 

A 1 1 s y m b o 1 s a re re m o v e d f r o m t h e s y m b o 1 t a b 1 e e \< o e p t t h e 
i n i t i. a 1 s y m b o 1 s u s e d b y t h e a s s e m b 1 e r < s e e a b o v e u n d e r 
Symbol Table* ) 



Z <symboI> 



T h e sy m b o 1 ? e :i. t h e r a v a r i a b 1 e o r a s s e m b 1 © r 1 a b e 1 ? i s 
removed from the symbol table snd the symbol table is 
compacted* 



Z> <symbol.': : 



A 1 1 s v* m b a I s d e f :i n e d a f t e r t h e s y m b o 1 si :i. v e n a s t h e a r <•* 1. 1 m e n t 
are r e m o v e d f r o m t h e s y m b o 1 t a b 1 e ♦ T h e s y m b o !l si :i. v e n a s 
the arslument is left intact* 



I N T E ( n o a r si u m e n t ) ( H u s e I n t e 1 F o r m a t " ) 

A 1 1 s u b s e « u e n t P c o m m a n d s a n d A s s e m b 1 e r c o m m a n d s w i 1 1 u s e 
t he I n t e 1 f o r m a t u n t i 1 a P R S i s e n c o u n t e r e d * 



P R S ( n o a r si u m e n t ) ( " u s e P r o e e s s o r T e c h n o 1 o si y F o r m a t " ) 

A 1 1 s u b s e « i..i e n t P e o m m a n d s a n d A s s e m b 1 e r c o m m a n d s w i 1 1 u s e 
the Pro c e s s o r T e c h n o .1 o si y F r o r m a t u n t i 1 a n I N T E i s 
e n c o u n t e r^d* 



P < I n t e r v a 1 A r si u m e n t > ( " P r i n t i n A s s e m b 1 e r F o r m a t " ) 

The interval si iven as argument is printed on the terminal 
with line numbers in assembler format? with label fields? 
opcode fields? operand fields? and comment fields in col- 
limns as determined by the TAB settinsls* The choice of 
Intel or Processor Techno lo sly format is unaffected by arM 
INTE or PROS p sue do -ops within the source code printed? 
but is affected by INTE or PROS commands as well as INTE 
or PROS pseudo-ops executed by the assembler durin si Pass 



TAB (no arslument) ("list TAB settinsls") 
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The current TAB settings are printed on the terminal in 
the following order* 

1. ♦ relative column for the label field 
2* " " " * opcode field 
3* • ■ " " " operand field 
4* " " " " comment field 

5* source code offset 

The columns for items 1-4 above are relative to for P 
command listings* and relative to item 5 for assembler 
listings* 

TAB <list of up to 5 arithmetic expressions separated fow blanks> 

The TAB setting items listed above are replaced bw the 
value of the corresponding expressions in the argument 
list* If there are less than 5 expressions in the list* 
items for which no expression is given are unchanged* The 
TAB is set to the low order bwte of the value of the 
expression* 



v" <Interval Arguments- ("Evaluate") 

The lower address of the interval given as argument is 
left in the HI... register pair arid the upper address in the 
the BE register pair* Nothing is printed on the terminal 
except for error messages* For use onlu in machine 
language programs calling the entrw point ATECOliS? where 
ATEC0M8 is a symbol in ATETBL ♦ A Jump to ATECDMS is 
written at memory location 0* 



Assembler Formats* 



Processor Technology Format* 

The label field begins in the first character of each line* If a 
statement is not to be given a label y the first character of the 
line must be blank* The label is given without an« symbol to ter- 
minate it* A label must contain only upper-case letters or digits 
and must begin with a letter* A statement consisting of only a 
label field assigns the value of the program counter to the label* 
The opcode field is separated from the label field by one or more 
blanks* If the statement takes an operandf the operand field is 
separated from the opcode field by one or more blanks* The com- 
ment field is separated from the previous field by one or more 
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b 1 a n k s ♦ The e n t i r © "I. i n e ca n ta e d e s A si n a t © d a s a co m m e n t b y g :i. v :i. n g 
>K a s t he firs t c h a r a c t e r o n t h e 1 i n e ♦ 

Intel Format* 

S a m e as above? w i t h the f o 1 1 o w i n g d i f f®r® n o e s ♦ a 1 a b e 1 i s t e r in i - 
ri a t e d w i t h a c o 1 o n ♦ I f a s t a t e m e n t i s n o t to b e g i v e n a 1 a b e 'I ? 
the opcode maw begin the line* The comment field begins with a 
semicolon ("$">♦ 



A s s e m b 1 e r P s e u d o •••• o p s * 



AORG ( M Address r i g i n ■ ) 

The assembler program counter ? &y is set to the value of 
the operand* 



SORG ("Storage Origin") 

The assembler storage counter y $y is set to the value of 
the operand 



ORG ("Origin") 

The assembler program counter is set to the value of the 
operand* The assembler storage counter is set to its 
current value + the new value of the program counter ~ 
the previous value of the prostram counter* 



DB < "Define Byte"" > 

The operand is defined as a one byte constant* Multiple 
operands separated by commas may bo? given* in which case 
a one-byte constant is defined for each operand * 

DW ("Define Word" ) 

Same as above except that constants defined are 16 bit 
words* 

D S ( ■ D e f :j. n e S t o r a de") 

A block of storage is defined whose length is the value of 
t h e o p e r a h d ♦ T h e s t o r a g e i s n o t i n i t i a I i z e d ♦ 
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ASC ("Define ASCII string") 

Generates a string constant consisting of the ASCII char- 
acters comprising the operand field* 

ASCx where 

x is anw printing non-alphabetic or di«*it character 

Same as ABC except that in the string Generated each 
occurrence of x is replaced taw a blank* 

EQU ("Eouate" ) 

The label of the EQU statement is assigned the value of 
the operand* A label must be present? &nd the same labe! 
cannot be #:i.ven a value taw more than one EQU statement* 



END Indicates the end of the source code* In the absence of 
a n E N D p s e u d o the end of f i 1 e s e r v e s t h e s a m e p u r p o s e ♦ 



INTE Sets the current format as the Intel Format 



PROS' Sets the current format as the Processor Techno I o$w 
Format ♦ 



I F < " Cond i t i oris 1 assemta 1 w " ) 

The operand must be in the form* 

< e x p r e s s i o n > v < 1 a b e 1 > 

If the value of the expression is Ov assemta Iw skips ahead 
t o t he I a ta e I ♦ 1 h e r w i s e a s s e m ta 1 w c o n t i n u e s w i t h t h e n e x t 
statement ♦ 



Assembler Error Codes* 



A Argument Error* The operand field is invalid for the 
siiven opcode* This will also occur at a statement Ibl 
after an IF pseudo of the form IF express ion» Ibl if the 
expression refers to Bn undefined variable* The A code 
u s u ally o c c u r s o n 1 w i n P a s s 2 * t h o u $ h a n i n v a I ;i. d E Q U 
operand w i 1 1 c a u s e i t t o o c o u r i n P a s s 1. ♦ 
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M 



M :i. s s :i. n g L a b © 'I. ♦ A n E Q U s t a t © m e n t o e e u r s w :i. t h o u t a 1 a b © 1 
P r i n t © d d u r :i. n g b o t h p a s s e s ♦ 



D o i..i b 1 y D e f :i. n e d I... a b el* A 1 a b e 1 :i. s g :i. v e n where t h e 1 a b e 1 :i. s 
identical to a sum bo 1 alr^eadw defined* 

I... a b e 1 E r r o r * T h e f i r s t e h a r a e t e r i n a 1 a b e 1 f i e 1 d i s n o t 
an upper -case letter of the alphabet* When this occurs? 3 
N P s w i 1 1 b e g e n e r a t e d i n p 1 a c e o f t h e s t a t e m e n t * 

p c o d e I::.' r y % o r * T h e o p c o d e f i e 1 d i s n o t a p r a p e r o p c o d e o r 
p s e i J d o - o p ♦ 3 N (!) P s w i 1 1 b e g e n e r a t e d i n p 1 a c e o f t h e 
statement ♦ 



S y m b o 1 s i n A T E T B I... X 



ATETBL is an abbreviation of the symbol table from an assemble of 
ATE? the nan- I/O portion of DISK A IE* It correlates with the 
version of Dl SKATE supplied* but in different versions of 01 SKATE 
the symbols in ATETBL maw not have the same value* Any reference 
to such a symbol should take its value from ATETBL itself artd not 
a listing of any previous version of ATETBL* 



BEGIN The beginning of ATE* This location is an entry point 
w h i c h per f o r m s i n i t i a 1 i z a t i o n ♦ T h e s t a c k a » ••» d s o m e 
i n t e r n a 1 v a r i a b 1 e s a r e i n i t i a 1 i z e d ♦ T h e c o m m a n d (!) » 7 » Y 
is executed y a message is printed on the terminal y arid 
the command 00 STARTUP is executed* 



RENT 



ATECOMS 



T h e e n t r y p o i n t t o A T E t h a t a v o i d s i n i t i a 1 :i. z a t i o n ♦ n 1 y 
t h e s t a e k i s i n i t i a 1 i z e d * I f D I S K A T E h a s b e e n c a 1 1 e d b y 
another machine lan«iuas*e prosfraiiu Jumping to this looa- 
t i o n w i 1 1 c a u s e t h e r e t u r h a d d r e s s t o b e 1 o s t ♦ 

An entry point which executes an arbitrary string of 
Dl SKATE commands and then returns* HI... must contain the 
a d d r e s s o f t h e b e <$ i n n i n & o f t It e o o m m a n d s t r i n si ♦ A ...i g m p 
to ATECOMS is written at memory location when Dl SKATE 
i s 1 o a d e d f r a m t h e d i s k + A T E C M S ivi a y b e i n v o k e d b bi 
loading the address of a command string in HI... and then 
exeeutiri5M the instruction RST 0* 



WHAT 



The entry point to the Dl SKATE error exit* A machine 
language program which detects an error can return to 
Dl SKATE by Jumping to this entry point* 
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READ A s u b r o u t i n e which re a d s o n e .1. i n e fro m t h e t e r m i n a .1 ♦ 

The characters are stored in the addresses beginning at 
the value in HI...* B contains a length byte which gives 
the maximum length of the buffer which begins at the 
a dd r e s s i n H I... ♦ A c o n t a i n s a p romp t c h a r a c t e r ♦ I f A 
contains there will be no prompt* 

UCHK A subroutine which determines if an argument follows the 
invokation of a machine language program* Returns with 
the Z flag OFF if an argument is present* 

DUALS A subroutine which evaluates an interval argument after 
the invokation of a machine language program* The lower 
address is placed in HI... and the upper address in DB* 
In case of error it exits \/ia WHAT rather than returning 
to the machine language program that called it* 

UAL US A subroutine similar to CUALS which evaluates an inter- 
val argument after the invokation of a machine langua*-1e 
p r o g r a m * T h i s r o u t i n e w i 1 1 y % e t u r h t o t h e c a 1 1 i n g p r o - 
gram even in case of error* Returning with the "I flag 
F F i n d i c a t e s an err o r ♦ W h e n c a 1 1 e d t h e 1 o w e r a n d u p p e r 
a d d r e <r> e s r e s p e c t i v e 1 w o f t h e i n i t i a 1 r e f e r e n c e i n t e r v a 1 
must be supplied in HI... and DE* The initial reference 
interval need not be given if it is known the argument 
w i 1 1 c o n t a i n n o m a t e h i n g s y m b o 1 s ♦ 

OUT A subroutine which prints the character in A at the 

term i n a 1 ♦ T h e I / d e v :i. c e n u m b e r is w h a t e v e r h a s b e e n 
established by an 10 command* and is at power -up* 
Before printing the character the panic detect routine 
is called* All registers and flags are preserved* a 
1 in e feed is. s u p p 1 i e d a u t o m a t i c a 1 1 w a f t e r a c a r r i a g e 
return* The internal print head counter is updated* 
When the terminal width is reached a carriage return and 
line feed are printed* 

INECO A subroutine whi-ch obtains a character from the terminal 
and echoes it via the OUT routine above* All flags and 
registers are preserved except A* which contains the 
input character* ESC and backspace are treated like arm 
Other character* 

PHI... SB A subroutine which prints the value in HI... in the current 
base? i n c 1 u d i n g 1 e a d i n g ' s ♦ T h e v a 1 u e i s p r i n t e d i n 
s p 1 i t for iti w i t h 3 d i «3 i t s p e r b w t e f o r a 1 .1 b a s e s o t her 
than .16* If the base is 16 4 digits are printed* 

PHI... DC A subroutine which prints the value in HI... in base 10 
suppressing leading 0's* 

USRCT An address giving the beginning of space provided inside 
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ATE for a user command table* 

ROMEND An address giving the upper address of space provided 
i n s i d e ATE f o r a u s e r c o m m a n d t a b 1 e ♦ 

UCTAD The address of a 16 bit value giving the address of the 
beg inning of the user command table* If this is not 
changed by personalization* the contents of 
U T AD** U C T A D + 1 o n p o w e r u p w i 1 1 b e t h e s a in e a d d r e s s a s 
USRCT* 

A ?) P C T h e a d d r e s s o f t h e a s s e m b 1 e r >» r o g r a m o o u n t e r ♦ 

STCTR The address of the assembler storage counter* 

BOSAP The address of a 16 bit value giving the lower address 
of the source area*. 

SYMTB The address of a 16 bit value giving the be?3 inning 
address of the symbol table* 

END The address in memory of the last byte of code in the 
module ATE* 

EOBAP The address of a 16 bit value giving the upper address 
o f t h e s o u r c e ar e a ♦ 

BOFP The address of a 16 bit value giving the lower address 
of the current file* 

EGFP The address of a 1.6 bit value giving the ui"'i" f (^v address 
o f t h e e u r r e n t f i 1 e ♦ 

TAB A The address of a 16 bit value giving the ending the 
symbol table* (Not consulted when values arts defined 
for a new symbol*) 

CHPTR The address of the entry pointer* 

PI. The address of a 16 bit value giving the lower address 
the last interval computed and the value of <♦ 

P2 The address of a 16 bit value giving the upper address 
the last interval computed and the value of >♦ 

RECAD The address of a 16 bit value giving the lower address 
the area of memory occupied by the most recently read 
r e cord f r o m d i s k ♦ 

RECND The address of a 16 bit value giving the upper address 
the area of memory occupied by the most recently r^ad 
r e c o r d f v o m d i s k ♦ 



DI SKATE User's Manual, ~i4<V 



ERSAU The address of a 16 bit value giving the address of the 
most recent program execution error? or the memory 
address at which a printout was interrupted *-- i*e* the 
value of ?♦ 

PHD The address of 1 byte value giving the column in which 
the print head is waiting* 

MAXBS A 16 bit constant giving the maximum number of blocks 
a 1 1 o w e d o n a d i s k d r i v e * 

DISKRUF The beginning address of the ATE disk buffer* After an 
T command a copy of the entire directory will beg.i, n at 
t h i s 1 o c a t i o n ♦ T h e f i r s t 1. 2 A b y t e s o f t h i s b u f f e r a r e 
used only during disk commands* The rest is *^hBr^6 by 
o t h e r b u f f e r s ♦ 

R A MEND The mid of RAM used internally by ATE* Memory above this 
address is free to the user* 
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J f n I I n w i n s= a p a si e n 1 1 m h e r i. n d :i. o a t e s t h *? p a g e n umber i s p a r t o f t h e 
System Reference Summary* Non alphabetic characters sv& gi vem in 
order of their ASCII codes ♦ 



A < a s s e m b I e r e r r o r code) 8 7 ? 1. 3 A ! 

A Command 84? 1,32! 

Al Command 84 m 132! 

A 2 C o m m a n d 8 4 ? 1. 3 2 • 

AORG Pseudo 80? I 35 ! 

A r g 1 1 m e n t m i <r * s i n g 2 

A y* g 1 1 in e i*i t P a s s i n si < t o m a c h :i n e 1 a n g lis g e ) 'I 9 

A r i. t h iyi e t i c E y, p r e s s i o n s 1. 1 7 ! 

ASC Pseudo 82? 136! 

ASPO 1.3?i 

ATI™ Command 94? 1.28! 

ATP Module 92 ? 9 A ? 107 

ATFCOMS 113? 1.37! 

ATFTBL 88 m 1.37! 

B Command 51? 1.24! 

Backspace key 4« 64? 11 6! 

B a s e ? c i ..i r r e n t 50? 5 1 

BEGIN 137! 

Block (disk) 65 

BOFP 1.10? 139! 

B o o t s t r a p p :i. n g 9 2 

BO SAP 110? 139! 

BYF Command 94? 128! 

C C o m m a n d 5 7 ? 124! 

CD Command 72? 131 ! 

CHPTR 139! 

COM Command 93? 128! 

Commands? format of 116! 

Compacting Disk 68 

o n e a t e n a t i o n 1 1 ? 5 2 ? 1 2 ! 

C o i..i n t :i. n g o c c u r r e n c e s 5 4 

Create disk file • see 8?T Commands 

Current Drive 64? 72 

C u r r e n t f i 1 e 1, ? 1. 7 ? 3 9 ? 4 2 ? 1 1 

Cursor frozen 4 

0UAI..S 109? 138! 

D ( a s s e m b 1 e v e r r o r c o d e ) 87? 1 3 7 ' 

D Command 43? 126! 

DB Pseudo 82? 1.35! 

D e c i m a 1 n u m b e r s 5 

DFF Command 48? 125! 

Default Interval Argument 121 ! See Argument missing 

Device numbers 61 ? 98 

D i recto py 65 ? 69 ? 73 ? 114 
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D :i. s k D rive D e s :i. «* n a tor 64? 121! 

Disk Drivers 101 

DISKBUF 114? 140! 

DS Pseudo 82? 135! 

DW Pseudo 82? 135! 

E oo mm and 1? 8* 11" 51? 52? 122! 

END (symbol in ATETBL) 139! 

END Pseudo 84? 136! 

End of the file 1.4* 30? 41 

Entry Pointer 1 

See target character 

Recovery from beinS in wronS place 32 
EOFP 11.0? 139! 
EOSAP 1.10? 139! 
ERSAU 1.40! 
EQU Pseudo 81? 1.36! 
ESC 4? 63? 116! 
F Command 39 ,* 125! 
F i 1 e n antes < d i. s k ) 64? 1 2 1 ! 
F i .1 e T y p e < d i s k ) 6 5 
F i. 1 e s ( m e m ory) 1? 39? 42? 1 2 1 ! 
FS Command 69? 1.30! 
G Command 46? 1.26! 
Global Search mid Replace 39 
G C o m in a n d 74? 1 3 ! 
H 50? 117! 

H e x a d e c i m a 1 n u m b e r s 5 
T Command 69? 130! 
IF Pseudo 83? 1.36! 
I n d e x e d S e e u e n t i a 1 F i 1 e s 142 
INEC.O 138! 

Initial Reference Interval 17? 40? 43? 46? 49? 1.18! 
INTE Command? Pseudo 79? 86? 133!? 136! 
Input Routine? Character 99 
Intel Format 78? 135! 
Interval 5? 117! 
I n t e r v a 1 A r <3 u m e n t 1 2 ! 
10 Command 61? 129! 
ID Jump Table 96? 101 
10 Module 92? 93? 96? 1.00 
J Command 85? 132! 
K Command 15? 56? 58? 123! 
KEEP (dummy variable) see JUNK? 77 
I... (assembler error code) 87? 137! 
L Command 70? 1.29! 
M (as s e m b 1 e r error o o d e ) 8 7 ? 1 3 7 ! 
M Command 31? 55? 56? 123! 
Macros 43 
N Command 39? 1.24! 
Match ins* 6? 17 
Matching Failure 38? 39 
MAXBS 140! 
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M e m o r « A d d r e s s ( :i. n d :i. r e c t o r w entry) 6 5 » 73 

N u m fo e r S w m b o 1 s 1. 1. 7 ! 

Negative numbers 10? 38? 5' 7 

(assembler error code) 87* 137! 

Command 54? 126! 

Obscure? J tide the 37 

Occur rencinef 8? 27? 120! 

Octal numbers 50 

ORG Pseudo 81? 135! 

OUT 138! 

Output Routine? Character 98 

P Command 1.4? 86? 1.33! 

PI 110? 1.39! 

P2 110? 139! 

Panic Detect Routine 99 

Panic State 48? 63? 116! 

Pass 1 (assembler) 75 

Pass 2 75 

P A U S E C o m m a n d 4 8 ? 1 2 1 ! ? 1 2 9 ! 

PHD 140! 

PHI...DC 138! 

PHLSB 1.38! 

Power -up Procdure 92 

P r i o r i t \.t of o p e r a t i o n s 1 2 ! 

P r o c e s s o r T e c h n o 1 o <3 w E o r m a t 7 8 ? 134! 

P r o m p t c h a r a c t e r 1 

PRNTSYM (example) 88 

PROS Command? Pseudo 79? 86? 133!? 136! 

Q (base suffix) 50? 117! 

Q Command 85? 132! 

QE Command 38? 127! 

Q S o m m a n d 46? 127! 

R Command 37? 45? 1.26! 

R AMEND 140! 

READ 138! 

RECAD 139! 

RECND 139! 

REE Command 49? 125! 

RENT 93? 137! 

RENT Command 94? 128! 

Reentry Point • — see RENT 

Return from macro 46 

RN Command 72? 131! 

R0MEND 111? 183! 

S (ir\ PBnic state) 63? 116! 

S o m m a n d 66 ? 1 3 ! 

Speed Constant 98 

S0RG Pseudo 80? 135! 

Source Area 1? 40? 43? 46? 54? 110 

Source E i 1 e ( d i sk ) 65 

STARTUP (file) 92? 106 

STCTR 139! 
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Symbols Table 75-78 » 107* 122! 



e x a m p 1 e o f pro «* r a in 
SYMTB 139! 
Sr 57 * 119! 
T Command 72* 131 ! 
TAB Command 85* 133! 
TAB A 122!* 139! 



to print 88 



T a r «* e t c h a r a o t e r 



2? 16* 24? 32 



Hi Command 73* 131 ! 

T e r m :i. n a 1 I n :i. t i a 1 :i. z a t :i. o n R o u t i n e 6 2 * 9 9 

T" 75 v 119! 

( i n S R G o p e r a n d ) 8 5 
I...! Command 69* 131 ! 
UCTAD 139! 

User C o m m a n d T a b 1 e 1 1 
USRCT 111* 183! 
V C a m m a n d 1 1 3 * 1 3 4 ! 
VALUS 109* 138! 
Variables 27* 75* 117! 
UCHK 109* 138! 
W Command 73* 1.31! 
WHAT 137! 
Win Command 62* 129! 



X 


C o m m a n d 5 9 * 1 2 7 ! 


Y 


C o m m a n d 6 2 * 1 2 9 ! 


2 


C o m m a n d 7 6 * 1 3 3 ! 


?::. 


«• Co m m a n d 7 6 * 1 3 3 ! 


j 


suffix 13* 11.9! 


n 


(as file name) 6 



* 121! 
" C o m m a n d 5 * 1 2 2 ! 

# Command 51* 124! 

# codes 4 51* 53* 1.18! 
$ ( a r «* u m e n t ) 7 9 y 1 1 9 ! 
$ C o m iti a n d 8 * 1 3 3 ! 
% suffix 9* 1.20! 
& (argument) 79* 1.19! 
fc Command 80* 132! 
' Command 4* 122! 
y (separating commands on 
one line) 25 

* 28* 117! 

* Command 44* 127! 
+ 28* 117! 

- 28* 1.17! 
-1! 14 

♦ Bee ♦ ♦ 
6* 11* 118!* 120! 

28* 117! 

50* 64* 117!* 121! 

21* 110* 11.9! 

• 30* 122! 

• 71* 121! 



+ ♦ 
/ 
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<S> 41 y 121! 

<T> 75 See Symbol Table 

« Command 27 y 128! 

> (prompt character) 1 

(Upper address of last interval) 18? 22 y 29? 1 10 v 119! 
? (argument symbol) 45 y <?>3y 119! 
'I* Command 53? 124! 
? H Command 67* 124! 
i? (as file name) 84* 121! 
# ( m a t c h :i. n «* s y m b o .1. ) 2 2 v 1 1 8 ! 
T t e x t "I ( in a t c h :l. n «* s y m b o 'I. ) 6 y 1 1 8 ! 
\ (echoed by ESC) 4 
'"* ( a r «•* it m e n t ) 2 4 y 1 1 9 ! 
" % Command 24 y 124! 
'"* (in ASC Pseud o operand) 83 
" (in ' command output) 4 
... 7y 8y 118! 
17» 22 y 120! 



